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1.Componenti grafici AWT ed eventi 
1.1 Componenti grafici 


1.1.1 Librerie AWT e Java Foundation Classes (JFC) 


Le interfacce grafiche utente (Graphical User Interface, brevemente GUI) per le applet e 
applicazioni Java sono gestite dalla libreria di classi Abstract Windowing Toolkit (AWT), 
contenuta nel package java. awt, con la quale si possono creare delle interfacce a finestre con 
grafica, componenti di interazione con l’utente e gestire gli eventi relativi. Questa libreria è 
generalmente considerata ancora un po' rudimentale, ma nelle versioni più recenti del JDK (con il 
JDK 1.1) è stata introdotta come libreria di sistema (compresa cioè nel core di Java), la libreria di 
classi chiamata Java Foundation Classes (JFC), creata da Sun (Javasoft) in collaborazione con 
Netscape ed IBM, totalmente portabile sulle varie piattaforme, che estende la AWT con un insieme 
di componenti grafici ad alto livello e servizi avanzati, che rappresentano un miglioramento per lo 
sviluppo delle interfacce grafiche utente (GUI) rispetto all'AWT del JDK 1.0 da vari punti di vista e 
offrono tra l'altro migliori prestazioni. Questa libreria, che spinge più avanti la frontiera di Java 
verso applicazioni sofisticate e di livello commerciale, riduce le differenze di aspetto e di 
comportamento dell'interfaccia grafica che si possono manifestare con l’AWT sulle varie 
piattaforme. JFC contiene un modello di eventi per delega (con eventi specifici per ogni classe, che 
vengono inviati direttamente all'oggetto interessato), la possibilità di stampa e di trasferimento di 
dati con il clipboard (operazioni di “taglia e cuci”), miglioramenti per la grafica e per le immagini, 
l'introduzione di operazioni senza uso del mouse, menù di tipo popup, contenitori a pannello 
scorrevole e diverse altre possibilità, oltre al supporto dei JavaBeans [7.1]. 


[7.1] paragrafo tratto da: JFC — Documentation, java.sun.com/products/jfc/docs.html 


[7.2] Java Foundation Classes, Now and the Future, White Paper, Sun. 


Dal canto suo Microsoft ha sviluppato il Software Development Kit (SDK) per Java che 
comprende le classi AWT del JDK di JavaSoft, ma contiene in più una libreria di classi chiamate 
Application Foundation Classes (AFC) con funzionalità rivolte ai JavaBeans, alla sicurezza e 
all'accesso diretto alle API Win32 di Windows con J/Direct per la creazione di interfacce utente 
[7.3]. 


[7.3] tratto da PCWeek Italia, 22 set 97, pag. 57 


1.1.2 Costituzione di un'interfaccia grafica 


L'interfaccia grafica di un'applicazione Java o di un'applet è in generale costituita da un 
componente grafico principale, che funziona da contenitore ed è di tipo derivato da Frame per 
un'applicazione e da Panel per un'applet, essendo ambedue queste classi derivate dalla classe 
Container, cioè capaci di contenere altri componenti, ciascuno dei quali può funzionare a sua 
volta come contenitore di altri componenti e così via in una gerarchia di contenitori e contenuti in 
cui ciascun componente è contenuto da un altro e può contenerne a sua volta altri. La posizione in 
questa gerarchia determina diverse cose: 


- il posizionamento dei componenti in assoluto sullo schermo che è definito in relazione al loro 
contenitore, 


- l'ordine di tempo con il quale gli elementi sono disegnati ogni volta che l’applicazione viene 
rappresentata sullo schermo (cominciando da quelli più esterni fino a quelli più interni), 


- il passaggio degli eventi da un componente a quelli superiori. 


1.1.3 Gerarchia dei componenti grafici dell'AWT 


Lo schema sottostante mostra la gerarchia di derivazione delle principali classi dell'AWT, Alla 
sommità della gerarchia, capostipite di ogni altra classe dell'AWT, sta la classe Component, che 
è astratta, e quindi non istanziabile direttamente, ma fornisce le funzionalità grafiche e di 
trattamento degli eventi di base di ogni componente grafico posto ovunque nella gerarchia di classi 
derivate. Tra le classi derivate possiamo distinguere da un lato i contenitori (oggetti derivati dalla 
classe Container, anch'essa astratta, tra i quali Panel, Window, Frame e Dialog), e 
dall'altro i componenti individuali come il Canvas e quelli di interazione con l'utente, come 
bottoni. menù di scelta, campi o aree di input (cioè Button, Choice, TextField e 
TextArea), che d’ora in poi chiameremo per intenderci componenti UI (dal termine User 
Interface) con il quale esse sono a volte conosciute. 
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1.1.4 La classe Component capostipite di tutti i componenti 
grafici 


Poiché la classe astratta (che esiste cioè solo come progenitrice di altre classi, ma che di per sé 
non può essere istanziata direttamente) Component è, come si è detto, la classe base capostipite 
di tutte le classi di componenti grafici, è importante conoscere subito almeno i metodi principali, 
che sono presenti per eredità in tutti gli altri componenti e conferiscono ad essi un minimo di 
funzionalità e comportamento comune. Quando si parlerà, tanto per fare un esempio, di un metodo 
paint) 0 setColor() della classe Applet bisogna tener presente che gli stessi metodi 
ci sono anche in una classe come la Button per esempio. 


Facciamo qui di seguito un elenco parziale dei metodi principali, ma si fa presente che i metodi 
sono molti di più (nell'elenco sono stati tralasciati, per alleggerire il testo, gli argomenti (0 
parametri) richiesti dai metodi, che si vedranno invece in dettaglio quando si parlerà di ciascuno di 
essi via via che se ne presenterà l’occasione): 











show() rende visibile il componente 





hide() nasconde il componente 

setForeground() stabilisce il colore di disegno sul componente 
getForeground() restituisce il colore di disegno sul componente 
setBackground ( ) stabilisce il colore di fondo sul componente 


getBackground{() resituisce il colore di fondo sul componente 


setFont () stabilisce il font da utilizzare nelle scritte sul componente 

getFont () restituisce il font utilizzato nelle scritte sul componente 

size() restituisce le dimensioni del componente 

setSize() stabilisce le dimensioni del componente 

getSize() restituisce le dimensioni del componente 

resize() stabilisce le dimensioni del componente 

reshape() posiziona sullo schermo € dimensiona il componente in pixel 
getGraphics()} crea e restituisce il contesto grafico tipo Graphics per il componente 


getFontMetrics() restituisce la metrica di un certo font 





setCursor () stabilisce il tipo di immagine del cursore 














paint (Graphics) 





disegna il componente sullo schermo 













update () aggiorna il disegno del componente 
repaint () ridisegna il componente 
createImage() crea un'immagine 


inside() 





verifica se i] componente contiene un determinato punto 






1.1.5 Definizione delle caratteristiche grafiche su un 
componente 


Le caratteristiche grafiche che si applicano quando si disegna o si scrive su un componente 


possono essere definite in due modi diversi, riferendosi al componente stesso oppure al suo 
contesto grafico: 


Esse possono essere fissate come Caratteristiche grafiche proprie del componente che, come 
oggetto di una classe derivata dalla classe Component, dispone a questo riguardo dei metodi: 

setBackground (Color) 

Set Foreground (Color) 

setColor (Color) 


setFont (Font) 


componente, per esempio se in esso è disposta un'etichetta (Label) con una certa scritta, questa 
sarà fatta con il colore e il font fissati in questo modo. 


Esempi# 


grafico di tipo Graphics associato al componente, con cui si può disegnare o scrivere (oggetto 


ottenuto con il metodo getGraphics(), Oppure passato automaticamente al paint() dal 
browser): 


g.setColor (Color) 
g.setFont (Font) 


Ci si pud allora chiedere quale dei due sistemi usare preferibilmente. E' da tener presente che le 
imposizioni fatte con il primo sistema prevalgono su quelli del secondo sistema. 


vedi Esempio# 





1.2 Componenti UI di interazione con l'utente 


1.2.1 I componenti di interazione 


I componenti grafici, tutti sempre derivati dalla classe Component, che l'AWT fornisce già 
preconfezionati al programmatore senza che egli debba preoccuparsi del loro disegno, e che 
costituiscono gli elementi di base per l'interazione con l'utente di un'interfaccia grafica, possono 
essere di tipo: Label, Button, Checkbox, List, Choice, TextField, TextArea, 
Scrollbar, Menu, Canvas. 


Questi componenti, che noi chiameremo componenti UI (User Interface) in quanto sono 
utilizzati per l'interazione dell’applicazione con l’utente, devono essere contenuti da un contenitore 
(cioè da un oggetto di classe derivata dalla classe Container). Per inserire uno di essi in un 
contenitore (ad esempio in un Panel o in un’Applet) lo si istanzia prima come oggetto e lo si 
passa quindi al metodo add(Component) del contenitore (add() è un metodo di cui 
dispongono la classe Container e le sue derivate), ad esempio del Panel, quest’ operazione 
essendo fatta di solito nel costruttore (o anche nel metodo init () se si tratta di un'applet). Ad 
esempio: 


Button bot = new Button(“OK”); 


ada(bot); 


oppure, con un'unica istruzione: 


add(new Button(“OK”)); 


ma in quest’ultimo modo non si ha a disposizione per il programma la referenza al bottone, con 
conseguenti limiti nell'uso. 


1.2.2 Componente Label 


Un Label (in inglese vuol dire etichetta e questo nome deriva dal suo frequente uso come 
etichetta per altri componenti) è costituita da un’area rettangolare contenente una stringa scritta sul 
componente che la contiene (di tipo Container o classe derivata). 


Il risultato grafico è lo stesso di quello che si può ottenere con il metodo drawString() di 
Graphics (vedi paragrafo 7.4.8), e infatti i due modi possono essere usati in alternativa per 
scrivere qualcosa su un contenitore e per certe cose, secondo le circostanze, il Label può avere 
dei vantaggi da vari punti di vista: 


- il suo disegno è automatico ogni volta che il contenitore viene ridisegnato e non richiede 
un'operazione specifica definita nel paint (}, 


- il suo posizionamento può essere automatico utilizzando un certo layout predefinito per il 
contenitore e non richiede così il calcolo dei pixel delle coordinate del punto di inizio, necessario 





invece con un drawString() (per un posizinamento preciso a livello di pixel il Label 
dispone comunque, come oggetto derivato da Component, del metodo reshape ()), 


- le scritte possono essere facilmente allineate (a sinistra, al centro o a destra) rispetto al 
contenitore. 


` 


Lo svantaggio è che la scritta di un Label è opaca in quanto il fondo rettangolare 


Esempio con i due modi:# 


I costruttori possibili sono: 





Label () crea un'etichetta con stringa ancora nulla che potrà essere 
successivamente definita con il metodo setText (String) 


Label (String) crea un'etichetta inizializzata con stringa data come argomento 
e con allineamento di default a sinistra 


Label (String, int) crea un'etichetta con stringa data e con un altro argomento per 
definirne l'allineamento sul contenitore, usando le variabili di classe 
Label. CENTER, Label.LEFT e Label . RIGHT, 

o i loro valori (rispettivamente 0, 1 e2) 







Metodi principali: 


setText (String) assegna all'etichetta il valore della stringa 
getText () restituisce il valore della stringa dell'etichetta 


setAlignment (int) stabilisce il tipo di allineamento (per il valore dell’ argomento vedi sopra) 


getAlignment() restituisce il tipo di allineamento (per i valori restituiti vedi sopra) 





Esempio con tre righe aventi tre diversi allineamenti e una riga con due stringhe.# 


Il risultato è riportato in figura 8.2. 





Figura 8.2 Vari Label con diversi allineamenti. 


Facciamo a questo punto un esempio di vari Label inseriti su un'applet: siccome l'aggiunta di 
un'etichetta è un'operazione molto semplice si è fatto qualcosa in più dell'inserimento di una sola 
etichetta mettendone una serie in un componente con una disposizione tipo GridLayout (vedi 
paragrafo 7.3.14) in una tabella che rappresenta una tavola pitagorica. 


// HOllabel.java (F.Spagna) Esempio di Label disposti su una griglia 
import java.awt.*; 
public class HOllabel extends java.applet.Applet { 
public void init() { 
setFont (new Font ("Courier", Font.BOLD, 16)); // fissa il carattere 


setBackground (Color.yellow) ; // colore di fondo 
setForeground(Color.blue); // colore delle scritte 


setLayout (new GridLayout (6, 10)); // disposizione a griglia 
for (int r = 1; r <= 6; r++) // per 6 righe 
for (int c = 1; c <= 10; c++) // per 10 colonne 
add(new Label("" + r*c)); // etichette con prodotto riga*colonna 





1 2 3 4 5 6.7 8 9 10 
2. 4.6 8.10 12 14 16 18 20 
3.6. 9.12 15 18 21 24 27 30 
4 8:12 16. 20 24 28 32 36 40 
5 10 15020 25 30 35 40 45 50 


6 12 18.24 30 36 42 48 54 60 


Figura 8.3 Vari Label disposti in una griglia. 


Ma nell’esempio precedente non viene dato un nome alle etichette, in quanto esse sono 
istanziate senza assegnarne una referenza, ma passando direttamente il new al metodo add() 
dell’applet. Può invece essere più utile poter disporre di un array di Label con un loro nome e 
ciò permetterebbe di poterne avere un controllo e cambiare la loro scritta o altre caratteristiche in 
qualunque momento nel corso di un programma. Segue un esempio in cui viene fatto questo che 
può essere visto come un esempio anche per qualsiasi altro tipo di componente, come una serie di 








Button odi Checkbox. Si noti che l’istanziazione con il primo new 


di referenze agli oggetti, ma non crea ancora gli oggetti 
di new successivo. 


dell’array crea un array 
stessi, che sono invece creati con il for 


Esempio:# 


1.2.3 Componente Button 


La classe Button rappresenta un bottone che 


può essere utilizzato dall'utente per far partire 
un'azione. 


I costruttori possibili sono: 


Button() 


crea un bottone senza nessuna scritta, 
che potrà essere poi aggiunta con il metodo setLabel (String) 


Button(String) crea un bottone con una determinata scritta 





Metodi principali: 


setLabel(String) assegna una scritta al bottone 
getLabel () 


restituisce il valore della scritta del bottone 





Diversi esempi con bottoni sono Stati fatti in questo testo a proposito dei vari gestori di layout e 
si rimanda ad essi (vedi paragrafo 7.3.12 e seguenti). 


Si fa qui un altro esempio di vari bottoni con diverse scri 
bottone è proporzionata alla lun ghezza della scritta che esso d 


Esempio:# 


tte, dove si vede che la larghezza del 
eve contenere. 


Figura 8.3 Vari Button con larghezze diverse in relazione alla loro scritta. 








1.2.4 Componente Checkbox 


Le Checkbox sono dei componenti che permettono all'utente di fare una scelta tra due 
Opzioni attivandone una 0 disattivandola, così che il programma potrà prevedere dei comportamenti 
diversi in base allo stato del componente. 


I costruttori possibili sono: 


Checkbox() crea una Checkbox non attivata 


Checkbox(String) crea una Checkbox affiancata a destra da un'etichetta con stringa data 


Checkbox (String,null,bool ean) 
erea una Checkbox: l'ultimo argomento stabilisce se essa è 
inizialmente attivata o no; il secondo argomento, che deve essere 
null perle Checkbox singole, può essere utilizzato per poterle 
riunire in gruppi assegnando ad esso la referenza dell'eventuale gruppo, 
come vedremo al paragrafo seguente 





Metodi principali: 


setLabel(String) assegna il testo dell'etichetta che affianca la Checkbox 
getLabel () restituisce il valore della stringa dell'etichetta che affianca la Checkbox 
set State (boolean) stabilisce lo stato della Checkbox (cioè se è attivata o no) 


getState() restituisce lo stato della Checkbox (true se attivatae false se no) 





La classe Checkbox, in relazione ad un eventuale gruppo in cui fosse inserita, dispone dei due 
metodi: 


setCheckboxgroup ( Checkboxgroup g) assegna una Checkbox ad un dato gruppo 


getCheckboxgroup () restituisce il gruppo cui appartiene una Checkbox 





Si fa qui un esempio di due Checkbox inserite in un'applet, una inizialmente attivata e l'altra 
no. 


// H02checkbox. java (F.Spagna) Esempio di Checkbox 





tti 
o= oe LÙPizme _ 









import java.awt.*; 





public class H02checkbox extends Java.applet.Applet { 






Checkbox chbl, chb2; 
public void init() { 

chbl = new Checkbox ("prima") ; // Checkbox normale 
chb2 = new Checkbox ("seconda", null, true); //Checkbox iniz.selezionata 
add(chb1); 


add (chb2) ; 











Figura 8.4 Due Checkbox, una disattivata ed una attivata. 


1.2.5 Gruppi di Checkbox e classe CheckboxGroup 


I vari componenti tipo Checkbox presenti in un contenitore possono essere tra di loro 
indipendenti Oppure riuniti (indipendentemente dalla loro posizione, ma solo logicamente) in 
gruppi nei quali vale la regola che una sola checkbox alla volta può essere attivata e tutte le 
altre sono allora disattivate, cioè ogni volta che si fa una scelta questa è esclusiva e disattiva la 
Checkbox precedentemente attivata (qualcosa come i radio buttons di Windows). E’ la classe 
CheckboxGroup che permette di collegare insieme vari componenti Checkbox in un gruppo. 
Per creare un gruppo si istanzia un oggetto di questa classe e poi si usa la referenza a quell'oggetto 
come secondo argomento nel costruttore quando si creano le varie Singole istanze di Checkbox 
(si ricordi il terzo costruttore visto al paragrafo precedente per Checkbox). 


Costruttore: 


Checkboxgroup () crea un gruppo di Checkbox 





Ecco un esempio in cui tre Checkbox sono riunite in un gruppo: 
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{t H03checkboxgroup. java (F.Spagna) Esempio di Checkboxgroup 






import java.awt.*; 


Public class HO3checkboxgroup extends java.applet.Applet { 






Checkbox chbi, chb2, chb3; 

public void init() { 

CheckboxGroup grup = new CheckboxGroup () ; 
chb1 new Checkbox ("prima", grup, false); 
chb2 new Checkbox ("seconda", grup, false); 
chb3 new Checkbox("terza”, grup, false); 
add(chb1) ; 
add(chb2); 
add(chb3); 











now ot 










Figura 8.5 Tre Checkbox riunite in un Checkboxgroup. 


1.2.6 Menù di tipo Choice 
I componenti di tipo Choice (che in inglese vuol dire scelta) sono dei menù a tendina (menù 
popup o pulldown) che permettono di selezionare una tra varie voci (le voci sono dette item). 


Un componente di tipo Choice viene creato istanziando un Oggetto della classe Choice e 
aggiungendovi poi, nell'ordine previsto, le varie voci (item) con il metodo addItem(String). 


Costruttore: 





Choice () crea un menù di tipo Choice senza ancora alcun item 






Per andare a vedere nel programma il dato selezionato e per preselezionare un item la classe 
Choice mette a disposizione i metodi: 
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Soe ee er e 





getSelectedIndex() che restituisce l'indice dell'item scelto (il primo ha indice 0) 


getSelectedItem() che restituisce la stringa dell'item scelto 


select(int) che preseleziona un item con il suo indice (per il primo l’indice 0) 


select (String) che preseleziona un item mediante la sua stringa 





Altri metodi della classe: 


getItem(int) che restituisce la stringa dell'item che occupa una certa posizione 


countItems () che restituisce il numero totale di item nel menu 





Esempio di un menù di questo tipo con tre voci, inserito in un'applet: 


// HO4choice.java {F.Spagna) Esempio di menu’ tipo Choice 
import java.awt.*; 
public class HO4choice extends java.applet.Applet { 


Choice ch; 

public void init() { 
ch = new Choice(); 
ch.addItem("prima voce"); 
ch.adaltem( "seconda voce”); 
ch.addItem("terza voce"); 
ch.addItem("quarta voce"); 
add(ch); 





In figura 8.6 viene mostrato come si presenta il menù dell’esempio in due situazioni diverse: 
all'inizio subito dopo la creazione e quando viene aperto dall’utente per selezionare una voce. 


prima voce 
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prima voce 


attira Oe 





Figura 8.6 Menù di tipo Choice in condizioni di riposo e quando è aperto. 


Altro esempio (con trattamento degli eventi): 


// HOSchoice.java (F.Spagna) Esempio di menu' tipo Choice 
import java.awt.*; 
public class HO5choice extends java.applet.Applet { 


Choice ch = new Choice(); 
Label lab = new Label ("nessuna scelta "yy 
String s[] = { "prima", "seconda", "terza" }; 
public void init({) { 

add(ch); 


for (int n = 0; n < 3; n++) 
ch.addItem(s[n]); 
add(lab); 


} 
public boolean action(Event evt, Object arg) { 
if {(evt.target == ch) 
lab. setText (ch.getSelectedItem() + " scelta = 
+ ch.getSelectedIndex()); 
return true; 





1.2.7 Liste scorrevoli (classe List) 


Una List è costituita da una serie di stringhe scorrevoli (scrolling) che assomiglia ad un 
componente di tipo Choice nel senso che permette una scelta da parte dell’utente tra varie voci, 
ma con le seguenti differenze: 


- non si aprono come fanno invece i Choice solo su richiesta dell'utente, ma sono mostrate 
sempre con un certo numero predeterminato di righe e possono essere scorse con delle barre di 
scorrimento quando il numero delle voci è maggiore del numero di righe contemporaneamente 
visibili sullo schermo; 


- può essere fatta dall’utente una selezione sia su una singola voce sia su più voci 
contemporaneamente, essendo questa, se una o più, una decisione che viene presa dal 
programmatore al momento della loro creazione (con il secondo costruttore dell’elenco che segue). 


I costruttori sono: 
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List() crea una List vuota 


List(int, boolean) 





Il metodo addItem( String), analogo a quello di Choice, permette l'aggiunta di nuove 
stringhe alla List. 


Esempio di List in un'applet, molto simile a quello fatto per il Choice nel paragrafo 
precedente: 






ii HO6list.java (¥. Spagna) Esempio di List 







import java.awt.*; 





public class HO6list extends java.applet .applet { 






List lis; 

Public void init() ¢ 
lis = new List(); 
lis.addItem("prima voce"); 
lis.additem("seconda voce"); 
lis.addItem("terza voce"); 
lis.addItem("quarta voce"); 
lis.addItem( "quinta voce"); 
add(lis); 











4quara voce 


Figura 8.7 Un esempio di List. 
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1.2.8 Componente TextField 


Un TextField è un campo di testo editabile che permette all'utente di introdurre da tastiera 
una serie di caratteri (compresi anche eventuali spazi) che possono essere letti dal programma sotto 
forma di stringa. 


La stringa contenuta in un TextField può avere più caratteri di quelli che entrano nel 
campo visibile, in tal caso ci si può muovere lo stesso all'interno della stringa con i comandi del suo 
editore di testo interno, anche se non si può vedere la stringa tutta insieme nello stesso tempo, ma la 
si può fare scorrere all'interno del campo. 


E' possibile far sì che i caratteri che l'utente inserisce da tastiera, pur correttamente introdotti 
nella stringa del TextField, non siano però visibili sullo schermo, ma siano mascherati da un 
carattere di eco, e questo è utile di solito per l'inserimento di password. Ciò si ottiene con il metodo 
setEchoCharacter(char) di questa classe, avente per argomento il carattere di eco sullo 
schermo che nasconde i caratteri reali inseriti, per esempio tipicamente: 


setEchoCharacter("“*”); 


I costruttori possibili sono: 


TextField() creaun TextField vuoto di larghezza nulla (non visibile) 


TextField(int) crea un TextField vuoto ma di larghezza visibile assegnata 
TextField(String) crea un TextField contenente una stringa preassegnata 


TextField(String,int) creaun TextField di larghezza data e con stringa assegnata 





Metodi principali, ereditati dalla classe genitrice TextComponent, e quindi posseduti anche 
dalla classe sorella TextArea (vedi paragrafo seguente): 


setText (String) prefissa un testo di partenza (di default) nel campo di input 
getText () restituisce la stringa contenuta nel campo di input 
getColumns () restituisce la larghezza del campo in numero di caratteri 
select(int,int) seleziona il testo compreso tra due caratteri (con i 2 indici) 
selectAll() seleziona tutto il testo nel campo 
setEditable(boolean) con un argomento false rende il campo non editabile 
isEditable() restituisce true se il testo è editabile 


setEchoCharacter(char) impone un carattere di eco che maschera l'input dell’utente 


echoCharIsSet () dice se l'input è mascherato da un carattere di eco 


getEchoChar() restituisce il carattere di eco eventualmente adoperato 
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Esempio di un TextField con una larghezza di 20 caratteri inserito in un'applet: 


// HO7textfield.java {F.Spagna) Esempio di TextField 
import java.awt.*; 
public class HO7textfield extends java.applet.Applet { 
TextField tf; 
public void init() { 


tf = new TextField(20); 
add(tf); 





In figura 8.8 è mostrato l'aspetto del TextFiela dell'esempio mentre l'utente sta 
introducendo dei caratteri (si può notare il cursore in fondo). 





Figura 8.8 Un TextField durante l'introduzione dei dati. 


1.2.9 Componente TextArea 


Una TextArea è un'area editabile che permette l'inserimento dei caratteri di un testo da parte 
dell'utente (o da parte del programma, e in tal caso serve piuttosto per presentare un testo sullo 
schermo in un riquadro scorrevole) similmente ad un TextField, ma con la possibilità di 
trattare testi di più grandi dimensioni distribuiti su più righe visibili su un'area di larghezza ed 
altezza prefissate dal programmatore, con una barra di scorrimento verticale che permette di 
scorrere verticalmente e orizzontalmente il testo quando esso ha un numero di righe maggiori di 
quelle contemporaneamente visibili sullo schermo 


I costruttori possono essere: 





TextArea() crea una TextArea vuota di dimensioni non definite (non visibile) 


TextArea(int,int) creauna TextArea vuota con numero di righe e di colonne dati 


TextArea(String) crea una TextArea senza dimensioni contenente un testo dato 


TextArea(String,int,int) creauna TextArea contenente un testo dato e con 
numero di righe e di colonne dati 





Essendo TextArea una classe derivata dalla classe TextComponent come 
Text Field, condivide con TextField diversi metodi di quella classe madre. Ma questa 
classe ha anche suoi metodi specifici: 


getColumns () restituisce la larghezza dell'area di testo (in numero di caratteri) 
getRows () restituisce il numero di righe visibili sullo schermo 
insertText (String,int) inserisce una stringa nel testo a partire da una posizione data 


replaceText(String,int,int)sostituisce il testo compreso tra due caratteri con un altro 
testo 





Fsempio di una TextArea inserita in un'applet: 


// HO8textarea.java (F.Spagna) Esempio di TextArea 
import java.awt.*; 


public class HO8textarea extends java.applet.Applet ({ 


TextArea ta; 

public void init() { 
ta = new TextArea(6, 15); 
add(ta); 





metterci del testo in un’altra che espone testo dato con setEditable(false)}# 


In figura 8.9 si vede l'aspetto assunto sull'applet dalla TextArea dopo che l’utente ha 


introdotto un certo numero di righe di testo (si può notare il cursore che è ancora alla fine 
dell’ultima riga). 


17 








Testo costituito d: 
prima riga 
seconda riga 
terza riga 
quarta riga] 







Figura 8.9 Un esempio di TextArea. 


1.2.10 Barre di scorrimento (classe Scrollbar) 


Le Scrollbar (barre di scorrimento) sono componenti grafici che permettono ad un utente 


di scegliere manualmente, agendo su un cursore, un certo valore compreso tra un minimo ed un 
massimo prestabiliti. 


Come è ben noto ad ogni utilizzatore di un sistema grafico a finestre, sia esso di tipo Windows, 
Macintosh o Motif (Unix), l'utente può fare con il mouse delle operazioni su una barra di 
scorrimento (equivalenti a variazioni della grandezza rappresentata dalla Scrollbar) in tre modi 
diversi: agendo sulle frecce poste alle estremità della barra per piccoli spostamenti del cursore, 
sulle zone della barra interne superiore o inferiore al cursore per spostamenti più grandi (una 


pagina), o infine trascinando direttamente il cursore (chiamato a volte anche “ascensore”) per 
spostamenti liberi. 


Disegno#: 


I costruttori disponibili sono: 


Scrollbar () crea una barra verticale con minimo e massimo uguali a zero 


Scrollbar(int) crea una barra verticale o orizzontale in relazione all'argomento 
che si può fissare con una delle due variabili di classe di tipo intero 
Scrollbar.VERTICAL e Scrollbar.HORIZONTAL 
(rispettivamente di valore 0 e 1) 


Scrollbar (int,int,int, int, int) avente cinque argomenti interi: 
il primo stabilisce se la barra é verticale o orizzontale (vedi sopra) 
il secondo dà il valore iniziale (compreso tra minimo e massimo) 
il terzo assegna la lunghezza della barra (in ..#) 
il quarto fissa il valore minimo 
il quinto fissa il valore massimo 
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Metodi principali: 


getMinimum{() restituisce il valore minimo 


getMaximum{) restituisce il valore massimo 


getOrientation() restituisce l'orientamento (0 se verticale e I se orizzontale) 
getValue () restituisce il valore corrente determinato dalla posizione del cursore 


setValue() stabilisce il valore corrente e posiziona il cursore di conseguenza 





Di seguito viene riportato un esempio con una barra orizzontale e valori compresi tra 0 e 100. E’ 
da tenere presente che le dimensioni della barra dipendono dal layout manager attivo (se il layout 
manager non è fissato la barra prende un aspetto anomalo): se per esempio si fissa un 
BorderLayout e si aggiunge una barra orizzontale a nord si ottiene una barra che corre lungo tutto il 
bordo superiore del contenitore, come nell'esempio. 


// HO9scrollbar.java (F.Spagna) Esempio di Scrollbar 
import java.awt.*; 
public class H09scrollbar extends java.applet.Applet { 


Scrollbar sbar; 

Label lab; 

public void init() { 
setLayout (new BorderLayout()); 
sbar = new Scrollbar (Scrollbar.HORIZONTAL, 50, 0, 0, 101); 
add("North", sbar); 


lab = new Label("" + sbar.getValue()); 
lab.setFont (new Font ("", Font . BOLD, 50)); 
add("Center", lab); 


} 
public boolean handleEvent (Event e) { 
if (e.target == sbar) { 
lab.setText("" + sbar.getValue()); 
return true; 
} 


return super.handleEvent (e); 





Il componente dell’esempio è mostrato in figura 8.10. 
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[Applet Viewer: scrolibarclass 
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Applet started. Applet started. 


Figura 8.10 Esempio di Scrollbar. 


fai due posizioni” 


1.2.11 Componente canvas 


La classe Canvas rappresenta un componente che dispone di una superficie rettangolare 
vuota sulla quale si può disegnare con i metodi dell'oggetto di tipo Graphics che viene passato 
al suo metodo paint () , € può anche, in quanto derivata da Component, intercettare gli eventi, 
e in questi suoi aspetti fa quello che può fare un Panel, ma, diversamente da questo, non essendo 
essa derivata dalla classe Container, non può contenere altri componenti. 


In generale viene creato un oggetto di una classe derivata da Canvas nella quale è ridefinito 
il metodo paint () e il metodo di risposta agli eventi, e quest’oggetto è aggiunto ad un 
contenitore con il metodo add(). 


Un Canvas può essere utilizzato per esempio come supporto per un'immagine che può essere 
sistemato in un contenitore per mezzo di un gestore di layout (layout manager). Esempio:# 
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1.3 Contenitori di componenti grafici 


1.3.1 Contenitori e classe Container 


Le classi di contenitori grafici, derivate, come ogni altra classe AWT, dalla classe 
Component, rappresentano dei componenti che possono contenere degli altri componenti AWT e 
quindi anche degli altri contenitori, e sono derivate dalla classe Container, che, essendo 
astratta, non può essere istanziata direttamente, ma in cui è predisposta la capacità di 
funzionamento come contenitore. L'ordine di aggiunta dei componenti è tenuto presente per certi 
effetti (vedi paragrafo 7.#). I componenti contenuti sono rappresentati in un array, variabile 
d’istanza del contenitore, Component components[]. 


Le classi dell'AWT di questo tipo sono Panel (e quindi anche Applet, che deriva da 
Panel), Window, Frame e Dialog. 


Oltre a ricordare tutti i metodi ereditati dalla classe Component (vedi paragrafo 7.1.4), 
riportiamo qui alcuni metodi specifici della classe Container: 


add (Component ) aggiunge un componente al contenitore 


remove (int) toglie un componente caratterizzato dal suo indice 


getComponent Count () restituisce il numero di componenti contenuti ne! contenitore 


getComponent (int n) restituisce il componente di indice n del contenitore 


Component [] getComponents() restituisce l’array dei componenti del contenitore 





1.3.2 Contenitori di classe Panel 


La classe Panel rappresenta un contenitore di componenti (che possono essere anche altri 
Panel) nella sua forma più semplice. 


Le dimensioni di un Panel (e quindi anche di un'Applet) possono essere conosciute 
attraverso il metodo size() che restituisce un oggetto di tipo Dimension, i cui membri 
width e height (cioè size().width() e size().height) danno la larghezza e 
l'altezza del Panel o Applet in pixel. 


Costruttori: 


Panel() creaun Panel con un layout di default di tipo FlowLayout 


Panel (LayoutManager) creaun Panel con un LayoutManager specificato 
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1.3.3 Oggetti di classe Applet come contenitori 


Essendo la classe Applet una sottoclasse della classe Panel, tutto quello che si può dire 
per Panel come contenitore vale anche per Applet, in altre parole si potrebbe dire che 
un'applet è in fondo, sotto l'aspetto delle caratteristiche di contenitore, un Panel, anche se ha poi 
tante altre funzionalità in più. E questo anche se la classe Applet, per la sua specificità è 
contenuta in un suo package a parte (il package java.applet) separato da quello delle altre 
classi AWT. 


1.3.4 Contenitori di classe Window 


La classe Window permette la creazione di finestre indipendenti, da quella del browser in 
un’applet e dal Frame principale del programma in un’applicazione, alle quali possono essere 
aggiunti dei menù. 


Questa classe fornisce la funzionalità di base di una finestra. Generalmente vengono usate le sue 
due sottoclassi Frame e Dialog (dialog box), che è un tipo di finestra più semplice. 


1.3.5 Contenitori di classe Frame 


La classe Frame rappresenta una finestra (è derivata da Window) con un titolo ed un bordo, 
che contiene in sé tutto il comportamento di una finestra e la possibilità di inserzione di una barra 
dei menù. 


I costruttori sono: 


Frame () crea una finestra di tipo Frame senza titolo 


Frame (String) crea una finestra di tipo Frame con un titolo assegnato 





Metodi: 


setTitle(String) permette di assegnare un titolo alla finestra 

getTitle() restituisce la stringa del titolo 

setMenuBar(MenuBar) aggiunge# 

getMenuBar () restituisce la referenza alla barra dei menù (oggetto MenuBar) 
isResizable() dice se la finestra è ridimensionabile 


remove (MenuComponent ) toglie la barra dei menù dalla finestra 


dispose () rilascia tutte le risorse impegnate dalla finestra e dai suoi componenti 
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per aggiungervi degli elementi grafici (ad esempio un Label 
per inserire una scritta), che Frame ha in quanto derivata della 
classe Container, 


per proporzionare le dimensioni della finestra stessa in relazione 
ai componenti che essa contiene. 





Ad un Frame si possono aggiungere dei componenti come in Panel con la funzione 
add(). Ma, contrariamente ai Panel in cui il gestore di layout (LayoutManager) di default 
era il FlowLayout, nei Frame il gestore di layout di default è il BorderLayout. 


Le dimensioni di una finestra possono essere assegnate con il metodo resize() e la 
posizione del vertice in alto a sinistra sullo schermo può essere stabilita con il metodo move (). 


Una finestra creata diventa visibile solo con il metodo show (), posseduto da ogni componente 
(oggetti di classe derivata da Component), che ha il suo contrario nel metodo hide() che la 
fa invece scomparire dallo schermo. 


Un Frame può produrre degli eventi propri come: 
WindowOpened, WindowClosing, WindowClosed, WindowIconified, 


WindowDeiconified, WindowActivated, WindowDeactivated. 


Esempio di pag. 281 ma senza la 2a classe # 


1.3.5.1 Creazione di una finestra 


Per creare una finestra in un'applet o in un'applicazione Java (nel caso di un'applicazione si può 
trattare della stessa finestra principale che ospita l'applicazione o di una nuova finestra a sé stante) 
si istanzia un Frame e se ne invoca il metodo show() per renderla visibile. 


Esempio di codice per la creazione di una finestra di tipo Frame:esempio completo# 


Frame f = new Frame(}; // crea una finestra 
f.setTitle("titolo"); // le da' un titolo 

f.add(new Label("scritta"); // vi aggiunge un componente (una scritta) 
f.pack(); // proporziona la finestra al contenuto 


f.show()}; // rende visibile la finestra 
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1.3.5.2 Chiusura di una finestra tipo Frame 0 Dialog 


Le finestre di classe Frame o Dialog non rispondono in generale al comando di chiusura 
tipico delle finestre perché tale evento non & previsto nella loro classe: per attivare questa 
funzionalità si può sottoclassare da esse una finestra particolare e ridefinirne il metodo di 
trattamento degli eventi handleEvent () (ogni classe derivata da Component ne ha uno) 
nel modo seguente: 


Esempio completo# 


public boolean handleEvent (Event ev) { 
if (ev.id == Event. WINDOW_DESTROY) 
dispose(); 
return super.handleEvent (ev); 
} 


Con il modello di eventi 1.1 una finestra tipo Frame chiudibile può essere creata con un 
codice come quello che segue: 






// HOOchiudib. java {F.Spagna) Finestra tipo Frame chiudibile 






import java.awt.*; 
import java.awt.event.*; 





Class FrameChiudibile extends Frame implements WindowListener { 






FrameChiudibile() { 
super("Frame chiudibile") ; 
addWindowListener (this); 








} 

public void windowClosing (WindowEvent e) { dispose(); } 
public void windowClosed (WindowEvent e) { } 

public void window0pened (WindowEvent e) { 3} 

public void windowActivated (WindowEvent e) { } 

public void windowDeactivated(WindowEvent e) { } 
public void windowIconified(WindowEvent e) { } 

public void windowDeiconi fied (WindowEvent. e) { } 














) 





public class H00chiudib extends FrameChiudibile { 







public void paint (Graphics g) { 
g.drawString("finestra chiudibile”, 20, 40); 






} 
public static void main(String s[]) { 











HOOchiudib fr = new HOOchiudib(); 
fr.setSize(320, 200); 

fr.pack(); 
fr.setVisible(true); 
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1.3.6 Contenitori di classe Dialog 


La classe Dialog, derivata dalla classe Window, permette la creazione di finestre tipo dialog 
box, più semplici di quelle di tipo Frame, che non possono avere dei menù e che sono di solito 
usate per mostrare avvisi all’utilizzatore o per ricevere da esso una risposta (un bottone OK su una 
Dialog la fa chiudere) o qualche dato (da cui il suo nome), anche se non ci sono limiti al loro 
uso come contenitori di componenti UI o per qualsiasi operazione grafica. 


Una Dialog ha sempre una finestra madre (parent) di tipo Frame (una Dialog richiede 
necessariamente un Frame preesistente). Il costruttore di questa classe richiede infatti il nome 
della finestra parent: si utilizza allora il metodo getParent() che restituisce la referenza ad un 
oggetto di tipo Container e quindi per avere un Frame è richiesto un casting .(9#) 


Come i Frame, anche le Dialog sono rese visibili solo con un metodo show(), mentre il 
metodo hide() le fa scomparire. 


Costruttori: 


Dialog (Frame, boolean) creauna Dialog collegata adun Frame 
con un argomento che stabilisce se essa è modale, 
cioè se richiede di essere chiusa prima che l’utilizzatore 


possa agire su altre finestre 


Dialog(Frame, String,boolean) come sopra, ma con una barra di titolo ed un titolo 





Esempio# 


1.3.7 Classe ScrollPane 


La classe ScrollPane del package java.awt è una sottoclasse di Container che 
implementa automaticamente in un contenitore la funzionalità di fare scorrere (scrolling) 
orizzontalmente e verticalmente al suo interno un singolo componente contenuto in esso (che di 
seguito chiameremo "child", cioè figlio) mediante scrollbar. Per le scrollbar può essere fatta una 
scelta ("display policy") tra le seguenti possibilità: 


- le scrollbar sono mostrate solo quando sono necessarie ("as needed") 
- le serollbar sono mostrate sempre ("always") 
- le scrollbar non sono mai presenti ("never") 

con un parametro fissato tra gli argomenti al momento della costruzione. 


Lo stato relativo alla posizione corrente del componente scorrevole child è rappresentato da due 
oggetti (uno per ciascuna dimensione) che implementano l'interfaccia Adjustable. A questi 
oggetti si può accedere con metodi della classe per rilevare o modificare gli attributi (come unità di 
incremento, valore, etc.). 
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Alcune proprietà (minimo, massimo, e quantita visibile) sono fissate internamente dallo 
ScrollPane in relazione alla geometria dello ScrollPane e del suo child e in generale non 
dovrebbero essere fissate dal programma. 


Anche nel caso in cui le scrollbar fossero definite come mai presenti ("never") il contenuto child 
dello scrollpane può essere fatto scorrere a programma usando il metodo 
setScrollPosition(). Questo si rende utile in particolare quando vengono usati nel 
programmma sistemi di controllo del movimento diversi dalle scrolibar (si veda l'esempio fatto in 
questo paragrafo). 


Le dimensioni iniziali del contenitore sono poste ai valori 100 x 100, ma possono essere 
impostate diversamente con il metodo setSize(). 


Per definire gli spazi tra le scrollbar e i bordi del contenitore si possono usare gli Insets 
(vedi paragrafo 7.3.17). Il valore attuale degli Insets può essere rilevato con il metodo 
getInsets() e può cambiare dinamicamente in modo automatico in dipendenza del fatto che le 
scrollbar siano al momento visibili oppure no. 


1.3.7.1 Variabili di classe 


Si fa qui un elenco delle variabili di classe, tutte public final static int: 





SCROLLBARS_AS_ NEEDED 


Specifica che le scrollbar orizzontale e verticale sono mostrate solo quando la dimensine del 
componente scorrevole child supera quella dello scrolipane contenitore in direzione orizzontale o 
verticale. 


SCROLLBARS_ALWAYS 


Specifica che le scrollbar orizzontale e verticale sono mostrate sempre, indipendentemente dalle 
dimensioni del conteniyoe scrollpane e del componnete scorrevole child. 


SCROLLBARS_ NEVER 


Specifica che le scrollbar orizzontale/verticale non siano mai mostrate. 





1.3:7:2 Costruttori 


ScrollPane() 


Crea un nuovo contenitore scrollpane con una "display policy" per le scrollbar posta per default al 
valore di "as needed". 


ScrollPane(int scrol lbarDisplayPolicy) 


Crea un nuovo contenitore scrollpane specificando con il suo argomento la "display policy" relativa 
a quando le scrollbar devono essere mostrate. 





26 





1.3.7.3 Metodi 


addImpl (Component comp, Object constraints, int index) 


Aggiunge un componente (comp) al contenitore scrollpane. Se lo scrolipane ha già un suo 
componente child, quel componente è rimosso ed è sostituito dal nuovo. 

I parametri sono, oltre al componente da aggiungere, constraints che non è applicabile e index che 
s1 riferisce alla posizione del componente child (deve essere <= 0) 

(ridefinisce il metodo addImpl() della classe Container). 


int getScrollbarDisplayPolicy() 


restituisce la "display policy" per la presenza delle scrollbar. 


Dimension getViewportSize{() 


Restituisce le dimensioni attuali (in pixel) del view port dello scrollpane. 


int getHScrollbarHeight () 


Restituisce l'altezza (in pixel) che sarebbe occupata da una scrollbar orizzontale, 
independentemente dal fatto che essa sia al momento mostrata dallo scrollpane oppure no. 


int getVSscrollbarWidth() 


Restituisce la larghezza (in pixel) che sarebbe occupata da una scrollbar verticale, 
independenteemente dal fatto che essa sia al momento mostrata dallo scrollpane oppure no. 


Adjustable getvadjustable() 


Restituisce un oggetto Adjustable che rappresenta lo stato della scrollbar verticale. Se la "display 


policy" per le scrollbar è "never", questo metodo restituisce null. 


Adjustable getHAdjustable() 


Restituisce un oggetto Adjustable che rappresenta lo stato della scrollbar orizzontale. Se la "display 


policy" per le scrollbar è "never" questo metodo restituisce null. 


setScrollPosition(int x, int y) 


Produce uno scorrimento fino alla posizione specificata entro il contenitore del componente child 
(si veda l'esempio fatto in questo paragrafo). Se si specifica una posizione che è al di fuori dei 
limiti legali di scorrimento del child lo scorrimento avverrà fino alla posizione legale più vicina. I 
limiti legali sono definiti quelli del rettangolo: x = 0, y = 0, larghezza = (child width - view port 
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width), altezza = (child height - view port height). Questo metodo, come anche il successivo, 
accede agli oggetti Adjustable che rappresentano lo stato delle scrolibar. 
I parametri sono la posizione x e la posizione y fino alle quali si fa lo scorrimento. 


setScrollPosition (Point p) 


Produce uno scorrimento fino alla posizione specificata entro il contenitore del componente child 
(si veda anche quanto detto per il metodo precedente). 

L'argomento rappresenta la posizione del punto (oggetto di tipo Point) fino al quale si fa lo 
scorrimento. 


Point getScrollPosition() 


Restituisce le coordinate (x,y) della posizione corrente di scorrimento entro il child che è mostrata 
alla posizione (0,0) del view port del panel fatto scorrere. Questo metodo, come anche il 
successivo, accede agli oggetti Adjustable che rappresentano lo stato delle scrollbar. 


setLayout (LayoutManager mgr ) 





Stabilisce il layout Manager per il contenitore. 

L'argomento rappresenta il layout manager specificato. 

(tidefinisce in modo specifico il metodo SetLayout() della classe Container: il metodo 
della superclasse è ridefinito come final per impedire che il layoutmanager sia manipolato. 


doLayout ( ) 


Ridimensiona il componente scorrevole child alle dimensioni preferite dal contenitore (se in tal 
modo la posizione attuale di sorrimento risultasse invalida, essa è posta alla posizione valida più 
vicina), 

(ridefinisce in modo Specifico il metodo doLayout () della classe Container). 


printComponents (Graphics g) 


Stampa il componente nello ScrollPane. 
Il parametro di tipo Graphics rappresenta la finestra specificata. 
(ridefinisce il metodo printComponents () della classe Container). 


String paramString() 


Restituisce il parametro String del contenitore. 
(ridefinisce il metodo ParamString() della classe Container). 


Viene qui fatto un esempio in cui un'immagine è disegnata su un Canvas che costituisce 
l'elemento scorrevole di uno ScrollPane inserito in un'applet. Lo scorrimento viene effettuato 
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con le scrollbar Presenti, ma anche a programma in relazione agli spostamenti del cursore de] 
mouse sopra un campione dell'immagine disegnata in un angolo dell'applet. 







FI H10scrol1051 
{i 01-05.10.98 1998) 






import Java.awt.#; 





public class HlOscrollosi extends Java.applet.Applet { 7/ nostra applet 








Scrolpan sp; // ScrollPane che l'applet conterra! 
Image img; 
Public void init() { // inizializza l'applet 







img = JetImage(getDocumentBase(), "logojava. jpg"), 
SP = new “o ronpan (ScrollPane. SCROLLBARS ALNAS img); 
add(sp); #4 aggiunge lo ScrollPane creato sopra 















Public void paint (Graphics 9) { // come disegna il nostro Canvas 
I.drawImage(im » 0, 0, 33, 43, this); 
//...impicciolita sull'appler 
public boolean mouseMove (Event e, int x, int y) { // se drag mouse 
if (x < 32 && y < 43) 
Sp. 8etScrollPosition(10*x, 10*y); 
return true; 


















} //...impicciolita sull'appler 
} 
Class 8Crolpan extends ScrollPane { // il nostro tipo di ScrollPane 
scrolpan(int i, Image img) { 1 costruttore dello ScrollPane 
+ super (i); 4/ costruttore della suoerclasse 
i SetSize(150, 150); {i dimensiona lo ScrollPane 
ua addImpl (new tela(img), null, 0) ;//aggiunge un Canvas 8Correvole 
} 
class tela extends Canvas { // il nostro tipo ai Canvas 











Image img; // immagine trattata dal Canvas 
tela(Image img) { // costruttore che richiede un'immagine 
SetSize (331, 432); tt dimensiona il Canvas 
this.img = img; {i immagine passata ai costruttore 
} 









public void paint (Graphics g) { // come disegna il Rostro Canvas 
9-drawImage (im , 0, 0, this); // disegna l'immagine sul Canvas 






} 








In figura 8.11 è Presentato il risultato del programma come visto dall’appletviewer. 
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UDe om oe 





E Applet Viewer: scrofl052 class 





Figura 8.11 Esempio di un’applet con uno ScrollPane contenente un Canvas 
Scorrevole. 


1.3.8 Componenti Menu e Menubar 


mediante il metodo add() dei Menu. 


Un Menu può essere disattivato con il metodo disable () della classe Menu, il cui 


vedi esempio# 


Un tipo speciale di voce (item) che si può aggiungere ad un menù è il CheckboxMenuItem, 
che è una voce contenente una casella selezionabile (checkbox), Questo componente, essendo una 
sottoclasse di Menur tem, viene trattato nello stesso modo di quello. 
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siente e L. 





Vedi esempio# 


Esempio completo# 


1.3.9 Finestra tipo Fi leDialog 


La classe FileDialog, derivata da Dialog, rappresenta una finestra di selezione per 
l'apertura o il Salvataggio di file. Si tratta di una dialog modale che blocca l'esecuzione dal 


momento in cui la finestra è mostrata con il metodo show () fintanto che non sia stata fatta una 
selezione sul file da parte dell’utente. 


Variabili di classe: 





FileDialog.LOAD 






variable relativa al caricamento ( load) di un file 












FileDialog. SAVE variable relativa al salvataggio (save) di un file 






Costruttori: 


potendo il modo essere pos 
O FileDialog. LOAD 






3] 





pa 


$ 
i 











FileDialog(Frame, boolean) crea una FileDialog collegata ad un 


Frame con un titolo (etichetta di Load File) 










FileDialog(Frame, String,boolean) come Sopra, ma con un argomento in più per 
scegliere il tipo di etichetta con una variabile di classe 
FileDialog.LOAD o FileDialog. SAVE 









Metodi: 






getDirectory ( Frame, boolean) restituisce la stringa del nome della directory selezionata 






SetFilenameFilter(FilenameFilter) stabilisce il filtro 


s SetFile(Frame, String, boolean) restituisce la stringa del nome del file selezionato 
| > getFilenameFilter() restituisce il filtro | 
| : getMode () restituisce il modo della FileDialog | 
| „a ParamString() restituisce il parametro String della FileDialog | 
| a SetDirectory(String) stabilisce una directory | 
| setFile (String) stabilisce un file | 
| | 






setMode (int) stabilisce il modo della FileDialog 







Viene fatto di seguito un esempio di un'applicazione che presenta un ment per fare delle 
operazioni di caricamento o salvataggio di file mediante le relative versione della FileDialog. 







{1 H11file061.java {F.Spagna) Esempio di FileDialog 
// 01-18,12.98 (inizio:18 dic 98) 










import java.awt.+* : 
import java.awt. event, *; 






public class H11file061 extends Frame 
implements ActionListener, WindowListener { 










String s[] = { "Apri", "Salva", "Chiudi" }: 





i 












TextArea ta = new TextArea(); // area di testo editabile 


file062() { 

















super ("Editore di testo"), // titolo della finestra 

add("Center", ta); #1 aggiunge l'area di testo 

MenuBar mb = new MenuBar (); // barra dei menu' 

setMenuBar(mb); 

Menu ml = new Menu("File"); // un solo menu' sulla barra dei menu' 

mb.add(mi); 

Menultem it[] = new MenuItem[3]; // 3 item nel menu' singolo 

for (int n = O; n< 3; n++) { // per ciascuno dei 3 item... 
it [n] = new MenuItem(s[n]}; // scritta item 
ml.add(it[(n]); // aggiunta item 
it [n] .setActioncommana(s[n}); // comando item 
it [n].addactionListener(this); // listner item 









} 
setSize(250, 300); 
pack({}); 










Public void windowClosing {WindowEvent ev) { System.exit (0); } 
Public void windowClosed (WindowEvent ev) { } 
public void windowDeiconi fied (WindowEvent ev) { } 
public void windowIconified (WindowEvent ev) { } 
public void windowActivated (WindowEvent ev) { } 
public voia windowDeactivated(WindowEvent ev) { } 
public void windowOpened (WindowEvent ev) { } 





public void actionPerformed (ActionEvent ev) { 
if ‘oy. getActionCommand () equals ("Apri") ) { 
FileDialog f = new FileDialog(this, "Apri", FileDialog. LOAD); 
£.show(); 
String fil = f.getFile(); 
ta.setText(fil); 




















pe 
th 





ey. getActionCommand() equals ("Salva") ) { 
FileDialog f = new FileDialog(this, "Salva", FileDialog.SAVE); 
£.show(); 

String fil = f.getFile(); 

ta.setText (fil); 










if sy getActionCommand() equals ("Chiudi") ) 
System.exit (0); 






} 
public static void main(String args[]) { 
file061 ed = new file06l(); 
ed.show(); 
ed.addWindowListener(ed); 










} 


1.3.10 Classi peer 
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1.3.11 Posizionamento dei componenti in un contenitore e classe 
LayoutManager 


della classe Panel, cioè si potrebbe dire che in fondo è un Panel speciale#) o di un Frame 
contenitore di un'applicazione, possono essere posti vari componenti (etichette, campi o aree di 
input, bottoni, o anche altri Panel o Canvas, etc.). 


Per inserire un componente (un qualunque oggetto derivato da Component) in un contenitore 
(oggetto derivato da Container) si ha a disposizione il metodo add( Component) della 
classe Container: se il componente non richiede un particolare trattamento ma può essere usato 


caratteristiche di risposta agli eventi previste nella superclasse, lo si può introdurre direttamente 
istanziandolo dalla relativa classe dell'AWT, altrimenti bisogna sottoclassarlo per conferirgli le 
caratteristiche volute. 


E' certamente possibile posizionare un componente all’interno del suo contenitore fissando la 
sua posizione e le sue dimensioni assolute definite in numero preciso di pixel sullo schermo con il 
metodo reshape (x, y, w, h), ma questo modo, che pur permette una scelta libera e 
precisa, potrebbe andare bene in una piattaforma determinata (per esempio quella stessa su cui si è 
sviluppato il Programma) e non su altre, dove potrebbe apparire disordinata. Per superare 
l'inconveniente di poter avere delle risposte diverse Sulle varie piattaforme su cui un'applet o 
un'applicazione deve essere eseguita riguardo a finestre, componenti o font, provvidenzialmente 
l'AWT dispone di un sistema ad alto livello (nel senso che libera dai dettagli) e flessibile per 


Per disporre gli elementi è utile definire un layout, cioè un tipo di disposizione, mediante un 
gestore di layout (layout manager) che Java fornisce e che si occupa di sistemare i vari componenti 
entro un contenitore. La posizione che ogni componente viene ad assumere sul suo contenitore 
dipende così dal LayoutManager definito per quel contenitore (il LayoutManager di 
default è il FlowLayout perun Pane] e il BorderLayout perun Frame, vedi paragrafi 


seguenti).sintetizzare# 


testo che vi devono apparire, dalla grandezza dei caratteri del font del componente e dalle 
dimensioni eventualmente prefissate, per esempio per i campi di input. 


Per assegnare un determinato gestore di layout ad un contenitore si usa il metodo 
setLayout (). 











1.3.12 Disposizione tipo FlowLayout 


Con il FlowLayout, che è quello adottato per default dall'AWT per i contenitori di tipo 
Panel, i componenti sono disposti tutti in fila uno dopo l'altro, nell'ordine da sinistra a destra con 
cui sono via via aggiunti al contenitore, su righe orizzontali, passando ad una riga successiva 
quando su una riga non ce ne stanno più. 


I componenti sono per default centrati orizzontalmente sulla riga rispetto ai bordi destro e 
sinistro del contenitore, ma questo allineamento può anche essere stabilito diversamente mediante 
un argomento del costruttore che può essere dato come FlowLayout. CENTER, 
FlowLayout.LEFT o FlowLayout. RIGHT, essendo questi valori definiti come variabili di 
classe nella classe FlowLayout. 


La distanza di default tra i componenti è di 5 pixel l'uno dall'altro, ma questa distanza, sia 
orizzontale sia verticale, può essere fissata ad un valore diverso, con argomenti passati ad uno dei 
costruttori, essendoci due costruttori disponibili, uno senza ed uno con la distanza come argomento, 


Costruttori: 


FlowLayout () creaun FlowLayout con un allineamento centrato ed una 
| distanza tra i componenti di 5 pixel orizzontalmente (dx) e 
3 verticalmente (dy) 
FlowLayout (int) creaun FlowLayout con un allineamento centrato e dx=dy=5 
FlowLayout (int, int dx,int dy) 
creaun FlowLayout con allineamento centrato e dx e dy dati 





L'istruzione con cui viene fissato per un contenitore un certo layout è del tipo: 


setLayout {new FlowLayout (FlowLayout. CENTER, 0, O)); 


Viene fatto qui un esempio di codice che piazza una serie di bottoni su più righe, 





// R12flowlay.java {F.Spagna) Esempio di disposizione tipo FlowLayout 






import java.awt.*; 


public class H12flowLay extends java.applet .Applet { 






public void init() { 
setBackground(Color.white); 
setLayout (new FlowLayout ()); // puo’ essere omessa perche’ di default 
for (int n= 0; n< 9; n++) 

add {new Button("Bottone" + n)); 

















Il risultato, Per un'applet cosiffatta, richiamata SUll'HTML con: 


<applet Code=botFlowLay.clags width=300 height=150></applet> 


è presentato nella figura 8.12. 





1.3.13 Disposizione tipo BorderLayout 


Con il BorderLayout i componenti sono disposti in relazione aj Quattro lati (border) del 
contenitore, Facendo in particolare l’ipotesi che j componenti da Sistemare siano dei bottoni, se essi 
non sono specificamente dimensionati vanno ad occupare tutto il Jato al quale sono Stati assegnati, 
con precedenza per quelli orizzontali, che SÈ sono soli nella riga si estendono per tutta la lunghezza 
del loro lato in priorità rispetto a quelli verticali. | bottoni sui lati hanno UNO spessore determinato 
dallo spazio minimo richiesto dalla scritta sy di essi (altezza dei caratteri in an senso e lunghezza 
della Stringa nell altro), mentre quello al centro occupa tutto Io Spazio che gli resta libero una volta 
che i bottoni lungo i bordi siano stati sistemati (fino a tutta l’area del contenitore se c’è solo un 
bottone di centro). 


Costruttori: 





Nel Programma, dopo aver Stabilito: 


SetLayout (new BorderLayout ()), 


ogni nuovo bottone viene aggiunto con un metodo di tipo: 


add("North”, new Button ("ox-) ), 


Il metodo ada () da adoperare in tal Caso è quello nella Sua versione che Prende un primo 
argomento costituito da una Stringa che si riferisce alla Posizione e che Può assumere j valori 











“North”, “South”, “West” o “East” a seconda del lato su cui si vuole piazzare il 
componente (rispettivamente alto, basso, sinistro e destro). 


Per imporre una distanza orizzontale e verticale tra i componenti si può usare un costruttore di 
BorderLayout che prevede le distanze come argomenti, come: 


setLayout (new BorderLayout (20, 20)); 


così come, se non si vuole che i componenti siano troppo vicini ai bordi e li si vogliono distanziare 
da essi, si può ricorrere al metodo insets() del componente (vedi paragrafo 7.3.17). 


Esempio di codice che piazza un componente (un bottone) per ognuno dei quattro lati ed un 
quinto al centro: 





import Java.awt.*; 





public class Hi3bordLay extends java.applet .Applet { 







Public void init() ¢ 
SetBackground(Color.white); 
setLayout (new BorderLayout ()); 
add("wWest", new Button("Bottone W"}); 
add("East", new Button ("Bottone E")); 
add({"North", new Button("Bottone N")); 
add("South", new Button("Bottone S")); 
add("Center", new Button("Bottone 





















Il risultato, per l'applet precedente richiamata sull'HTML con: 


<applet Code=sbotBordLay.class width=300 height=150></applet> 


è presentato in figura 8.13. Dalla figura risultano chiari i criteri accennati relativamente a 
lunghezza e Spessore dei bottoni, In particolare si vede come i bottoni N e S, essendo su lati 
orizzontali, vengono ad occupare tutto il loro lato, mentre j bottoni W ed E sui lati verticali devono 
accontentarsi della lunghezza libera rimasta su quei lati, ed infine come il bottone C viene ad 
occupare tutto lo spazio restante al centro. Si può Osservare anche come gli spessori dei bottoni sui 
lati verticali si adeguano automaticamente alle dimensioni delle scritte orizzontali che vi devono 


essere apposte. 
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Figura 8.13 Posizionamento di bottoni con il BorderLayout. 


Altro esempio con Frame:# 


1.3.14 Disposizione tipo GridLayout 


posizione dei componenti per righe e colonne nelle celle di 
una griglia a maglie regolari (a questo tipo bisogna ricorrere se si 


Costruttori:# 





GridLayout () creaun GridLayout 






GridLayout (int r,int c) creaun GridLayout con numero dato di righe e colonne 
GridLayout (int r,int c,int dx,int dy) 






creaun GridLayout con numero di righe e colonne dati e 
distanze dx e dy tra i componenti assegnate 


Per fissare il layout: 


setLayout (new GridLayout (numRig, numCol, distoriz, distvert)); 


Esempio di codice che dispone su 4 colonne una 


serie di bottoni (oggetti Button) e di 
etichette (oggetti Label) alternati: 


// Hldgridlay. java {(F. Spagna) Esempio di disposizione tipo GridLayout 





import java.awt.*; 





public class Hl4gridLay extends java.applet .Applet { 





public void init() ¢ 
setBackground(Color.white); 
setLayout (new GridLayout (0, 4, 10, 12)); 
for (int n = O; n < 9; n++) { 
add (new Button("Bottone * + n)): 
add (new Label ("Etichetta » + n)); 
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Il risultato, per un'applet così definita e richiamata Sull'HTML con: 


<applet Code=botBordLay.class width=300 height=150></applet> 


è presentato in figura 8.14. 


1 Elichetta 0 Bottone 4 Etichetta 1 
Etichetta 2 Boline: i] Etichetta 3 
Etichetta 4 ‘Bati mes Etichetta 5 

Ë| Etichetta 6 „Botons #1] Etichetta? 


Etichetta 8 


con la possibilità in più che un componente può occupare più di una maglia, 
adattandosi ad una serie di suggerimenti dati mediante Ja classe ausiliaria 





GridBagCons traints che definisce come ciascun componente è tracciato all'interno 
display area. 


gridx e gridy 


che riguardano la Posizione orizzontale € verticale nella griglia 


sridwidth e gridheight 
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che riguardano le dimensioni ori 
fill 










che stabilisce seul 


display area (si fissa con una delle variabili di cl 
VERTICAL, BOTH) 


weightx e weighty 







stabiliscono la distribuzione tra i vari componenti degli spazi extra in senso orizzontale e in 
Senso verticale quando si ridi 


imensiona il contenitore (si assegna loro un valore Compreso tra 0. e 
1.0, mentre il valore di default è 0.) 









anchor 





che specifica dove viene posto il componente nella sua display area (si fissa con le variabili di 
classe GridBagConstraints. NORTHWEST. NORTH, etc.) 


insets 









con esso si stabilisce lo Spazio tra il comp 


ipadx e ipady 






Onente e i bordi della sua display area 







stabiliscono le aggiunte di Spazi interni al 





componente nelle due direzioni. 









Costruttore: 






GridBagLayout {) creaun Gri dBagLayout 





import java.awt.*; 


Public class HlSgridbag extends java.applet applet { 





Public voig init () { 






GridBagLayout gb = 
setLayout (gb); 


GridBagconstraints C = new GridBagConstraints(), 


new GridBagLayout (); 























for (int n = 0; n< 3; n++) 
for (int i = 0; i< 3; i++) { 
c.gridx = i; c.gridy = n; 
c.gridwidth = 1; c.gridheight = 1; 
Button b = new Button("bottone" +n + i); 
gb.setConstraints(b, c}; 
add(b); 












} 
c.gridx = 0; c.gridy = 3; // la colonna e 4a riga 
c.gridwidth = 2; c.gridheight = 1; // larghezza di due colonne 
c.fill = GridBagConstraints.HORIZONTAL; 

Button bl = new Button("germania") ; 
gb.setConstraints (bi, c}; 
add {b1}; 














c.gridx = 3; c.gridy = 0; // 4a colonna e la riga 
c.gridwidth = 1; C.gridheight = 2; // altezza di due righe 
¢.fill = GridBagConstraints.VERTICAL; 

Button b2 = new Button ("bretagna"); 

gb. setConstraints(b2, c); 

add (b2); 








In figura 8.15 è mostrato il risultato. 





Figura 8.15 Esempio di disposizione di componenti tipo GridBagLayout. 


1.3.16 Disposizione tipo CardLayout 


Il gestore di layout tipo CardLayout permette di creare per un contenitore diversi altri 
contenitori (0 card) ciascuno con un suo proprio nome, che possono apparire solo uno alla volta sul 
contenitore principale corrispondentemente al metodo show(this, Panel) della classe xx# 
che di volta in volta può essere chiamato. Ognuno dei contenitori componenti può avere i suoi 
propri componenti ed un suo proprio layout, così che l'aspetto che il contenitore principale viene ad 
assumere può essere di volta in volta diverso. 


Costruttori: 


4i 

















CardLayout () creaun CardLayout senza distanza tra i componenti 


CardLayout (int dx,int dy) creaun CardLayout con distanze dx e dy date 





Esempio:# 


Figura 8.16 Esempio di disposizione tipo CardLayout. 
v. libro p.254# 


#rivedi seguente 
add(“primo”, pan1): 


show(this, “primo”); 
Usando il metodo add() del contenitore nella forma: 
add(String nome, Component comp); 


che assegna un nome al componente e poi il metodo show() 


1.3.17 Distanza dei componenti dai bordi (Insets) 


La distanza dei componenti inseriti in un contenitore da ciascuno dei quattro bordi di esso può 
essere Imposta ridefinendo per il contenitore il metodo insets() che ogni contenitore eredita 
dalla classe Container così: 


public Insets insets() { 
return new Insets(a, b, ac, d}; 
} 


Ove i quattro argomenti del costruttore di Insets rappresentano le distanze nell'ordine dal 
bordo superiore, inferiore, sinistro e destro del contenitore. 


Si fa qui di seguito un esempio:# 
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1.3.17.1 Suddivisione di un contenitore in altri contenitori 


L'area di un contenitore, ad esempio un Panel, può essere suddivisa in diversi altri contenitori 
(sottocontenitori), ad esempio altri Pane] (pannelli annidati o nested Panels), per poter così 
avere maggiore flessibilità nel distribuire į componenti all'interno di esso, potendo ciascuno dei 


sottocontenitori e così di Seguito, si viene a formare una gerarchia di contenitori e componenti 
contenuti che, partendo dal contenitore principale, scende via via fino ai componenti più interni. La 


Panel pi = new Panel (); 
Panel p2 = new Panel (); 


vedi esempio di pagina 258 del libro # 


al pannello principale quando la si definisce perchè il pannello interno possa per suoi eventi 
comunicare con il suo contenitore invocandone i metodi. Infatti in tal caso bisogna che il subpanel 
possa conoscere il suo pannello contenitore perché possa passargli ... e per questo si deve 
prevedere che il suo costruttore riceva come argomento la referenza al contenitore. Così, quando si 
istanzia il Subpanel nella classe del contenitore principale, gli si passa come argomento nel 
Costruttore il this e Jato subpanel la referenza dell’oggetto contenitore come 
variabile.(semplificare#) 


#ESEMPI di libro 


1.3.18 Disposizione con vari layout composti 


Poichè ad un contenitore si può associare un gestore di disposizione componenti ed un 
contenitore può comprendere a sua volta diversi altri contenitori, ciascuno con il suo proprio 
gestore, vari gestori possono essere combinati insieme in cascata e si possono così sfruttare 
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di vari /ayout diversi definendone ciascuno su un suo specifico Panel e componendo quindi i 
vari Panel inun layout generale. 


Esempio di codice che sistema due Panel con layout di tipo diverso (uno di tipo 
Flowlayout ed uno di tipo Borderlayout) sullo stesso contenitore, 





// H16piuLay. java (F. Spagna) Esempio di disposizione con vari layout 






import java.awt,*; 


public class Hl6piuLay extends java.applet .Applet { 






public void init() { 






setBackground(Color.white); 





Panel pf = new Panel(); 
PÎ.setLayout (new FlowLayout ()}; 
for (int n = O; n< 4; n++) 

pft.add (new Button("Bottone * + n}}; 








Panel pb = naw Panel(); 

Pb. setLayout (new BorderLayout ()); 
pb.add("west", new Button("Bottone Ww")); 
pb.add("East", new Button("Bottone E")); 
pb.add("North*, new Button ("Bottone N")); 
Pb.add( "South", new Button( "Bottone S")); 
pb.add("Center", new Button("Bottone C")); 








add( "North", Pf); 
add("South", Pb); 





Il risultato, per un'applet così definita e richiamata sull'HTML con un’applet di dimensioni 300 
x 150: 


<applet code=botBordLay.class width=300 height=150></applet> 


è presentato in figura 8.17. 
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stent 





Figura 8.17 Posizionamento di bottoni con due layout composti. 
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1.4 Eventi 


1.4.1 Programmazione ad eventi 


~ 


Il linguaggio Java è predisposto per una programmazione ad eventi. Contrariamente alla 
programmazione procedurale, secondo la quale il programma ha un flusso cosiddetto top to 
bottom, cioè che fa un percorso dalla cima al fondo, nella programmazione ad eventi ogni 
programma (un programma ad eventi è detto in inglese event driven) resta continuamente in un 
loop di attesa di eventi esterni. Un evento può essere generato da un'azione dell'utente, come la 
battuta di un tasto, un clic o lo spostamento del cursore del mouse, la chiusura o l'apertura di una 
finestra o il suo scorrimento, ma anche da fatti esterni come ad esempio dei dati in arrivo dalla rete 
o su una porta, etc. Gli eventi via via che si producono vengono posti in una coda di eventi dal 
sistema operativo, che li raccoglie e li smista ai vari programmi, secondo la loro destinazione. Ad 
ogni ciclo del loop un programma cerca nella propria coda il prossimo evento e, se ne trova uno, 
attiva il corrispondente metodo previsto in risposta all'evento. Perciò nella classe di definizione 
dell'applet, o di un'applicazione Java indipendente, possono essere definiti una serie di metodi che 
devono rispondere ai possibili eventi (tali metodi sono detti in inglese event handler, cioè “che 
trattano gli eventi”). Nel caso delle applet non è necessario programmare il loop di attesa di eventi, 
in quanto è il browser stesso che ne fornisce uno. 


Gli eventi in Java sono trattati dall'AWT (Abstract Windowing Toolkit) rappresentato dal 
package java.awt, che gestisce i componenti dell'interfaccia grafica utente, ed è in questo 
package che si trova la classe Event che, come vedremo, serve per rappresentare gli eventi. 


1.4.2 Modello di gestione degli eventi del JDK 1.0.2 


1.4.2.1 Gestione degli eventi e metodi di risposta ad essi 


Alcuni degli eventi che possono prodursi durante l’esecuzione di un programma sono trattati 
automaticamente da Java o dal browser, come ad esempio la chiamata del metodo paint () 
quando un componente deve essere ridisegnato (evento di paint), ma altri eventi devono essere 
trattati espressamente dal programmatore, come quelli che sono prodotti da un input 
dell'utilizzatore su un componente UI di interazione, che prevedono sempre delle azioni specifiche 
conseguenti. 


Nella versione 1.0.2 del JDK per la gestione degli eventi che interessano un componente si 
dispone di vari metodi tra cui i due handleEvent() e action() ereditati da ogni 
componente dalla superclasse Component. Quando un evento si produce nel componente il 
sistema chiama il metodo handleEvent (Event) passando ad esso come argomento 
un'istanza della classe Event, generata dal sistema al momento dell’evento, che contiene le 
informazioni che caratterizzano l'oggetto su cui l'evento è stato prodotto, il tipo di evento, il tempo 
e la posizione in cui esso si è prodotto. 
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La classe Event, che descrive un evento, infatti possiede, tra le altre, una variabile d'istanza 
id che caratterizza (ne porta in sé l'informazione) il tipo di evento di cui essa rappresenta 
l'identificatore, secondo una tabella definita da tutta una serie di variabili final static di 
classe definite all'interno della classe stessa Event, con le quali può essere confrontata quando si 
passa un oggetto di tipo Event ad un metodo che si occupa del trattamento degli eventi. 


Il metodo handleEvent() della classe Component, superclasse di ogni componente 
(classe di base all'origine di tutti gli oggetti grafici, che è automaticamente chiamato dal sistema in 
seguito al verificarsi di un evento, nella sua versione di default, che è quella definita nella 
superclasse Component, possiede già una certa funzionalità di base per la gestione di vari eventi 
(come ad esempio la chiamata dei metodi relativi a mouse e tastiera). Questo metodo è però in 


generale ridefinito in un programma: 


- per trattare eventi di sistema non compresi nella versione originale del metodo della 
superclasse Component, 


- per cambiare il comportamento previsto nel metodo originario, 
- per prevedere nuovi tipi di eventi. 


Il metodo handleEvent (), tra i vari metodi per il trattamento degli eventi, è quello più 
generale che permette di intercettare e trattare gli eventi di ogni tipo sui componenti e viene usato 
generalmente nella forma seguente, in cui viene fatto un test, con uno switch (oppure una serie 
di if), sul tipo di evento mediante l'identificatore dell'evento, e più precisamente la variabile di 
istanza id dell'oggetto di tipo Event, contenente le caratteristiche dell'evento, che il sistema 
operativo crea e passa come argomento al metodo per ogni evento che si produce. Nella classe 
Event sono definite una serie di variabili (in effetti costanti final) di classe (static), che, 
essendo intere, si prestano ad essere usate in uno switch (vedi tabella seguente). 


Identificatori di eventi di mouse e tastiera: 


Event .MOUSE DOWN evento generato quando si preme il bottone del mouse sul componente 
Event .MOUSE_UP evento generato quando si rilascia il bottone del mouse sul componente 
Event .MOUSE_MOVE evento generato quando si muove il cursore del mouse sul componente 


Event .MOUSE_DRAG evento generato quando si muove il cursore del mouse sul componente 
con il bottone premuto 


Event .MOUSE_ENTER evento generato quando il cursore del mouse entra nel componente 


Event .MOUSE_EXIT evento generato quando il cursore del mouse esce dal componente 


Event . KEYPRESS evento generato quando si preme un tasto 


Event .KEYRELEASE evento generato quando si rilascia un tasto 


Event .KEYACTION evento generato quando è effettuata un'azione su un tasto 
(un'azione consiste in una pressione seguita da un rilascio) 
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Il metodo handleEvent () non fa altro che chiamare a seconda dell'evento il metodo 
specifico dell’evento stesso, come si può vedere bene dalla sua definizione tratta dal JDK e qui 
sotto riportata integralmente: 





public boolean handleEvent (Event evt) { 






switch (evt.id) { 









case Event .MOUSE_ ENTER: 
return mouseEnter(evt, evt.x, evt.y); 







case Event.MOUSE_EXIT: 
return mouseExit(evt, evt.x, evt.y); 






case Event.MOUSE_MOVE: 
return mouseMove(evt, evt.x, evt.y); 






case Event .MOUSE_DOWN: 
return mouseDown(evt, evt.x, evt.y); 









case Event .MOUSE_ DRAG: 
return mouseDrag(evt, evt.x, evt.y); 






case Event .MOUSE_UP: 
return mouseUp(evt, evt.x, evt.y); 







case Event.KEY PRESS: 
case Event .KEY ACTION: 
return keyDown(evt, evt . key); 








case Event.KEY RELEASE: 
case Event . KEY_ACTION_RELEASE: 
return keyUp(evt, evt.key); 











case Event .ACTION EVENT: 

return action(evt, evt.arg); 
case Event .GOT_FOCUS: 

return gotFocus (evt, evt.arg); 
case Event.LOST FOCUS: 

return lostFocus(evt, evt.arg); 








} 


return false; 





Nell'esempio seguente si riporta una ridefinizione del metodo in cui sono considerati solo alcuni 
tipi di eventi. 


boolean handleEvent (Event ev) { 
switch (ev.id) { 
case Event.MOUSE_DOWN : /* istruzioni */ ; break; 
case Event.MOUSE UP : /* istruzioni */ 3 break; 
case Event .MOUSE_MOVE : /* istruzioni */ ; break; 
case Event .ACTION EVENT : 
if (ev.target == bottonel) /* istruzioni */ 
if (ev.target == bottone2) /* istruzioni */ 
if (ev.target == bottone3} /* istruzioni */ 


No we na 
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break; 
} 
return Super. handleEvent (ev); // recupera la funzionalita’ della superclasse 
} 


#INSERIRE ULTIMI 3 righi pag.234 


Nel ridefinire il metodo in una nuova classe si viene a perdere la funzionalità originale 
contenuta nel metodo della Superclasse, e se si vuole recuperarla, basta richiamare il metodo della 


handleEvent () della superclasse, è, nella maggior parte dei casi, necessaria in quanto tutti gli 
altri eventi previsti nella superclasse (per esempio il MouseDown()) che non sono trattati 
esplicitamente nel metodo che si sta scrivendo potranno essere poi trattati nella loro versione di 
default della superclasse Component, altrimenti il loro trattamento andrebbe perso. 


Per trattare gli eventi di tipo mouse e tastiera si Possono usare direttamente i metodi specifici 
tipo mouseDown() e keyDown() che riportiamo nei paragrafi seguenti e che non richiedono 


1.4.2.2 Metodi specifici rispondenti agli eventi del mouse 


Eventi del mouse sono prodotti da una pressione (clic) sul tasto (quello di sinistra se il mouse ne 
ha più di uno) o Spostamenti del cursore del mouse nell'area del componente, o anche azioni 
combinate di clic e spostamenti, La classe Component contiene diversi metodi di risposta agli 
eventi prodotti da azioni sul mouse da parte dell'utente ai quali sono passati, oltre al solito oggetto 
di tipo Event, altri due argomenti che sono le coordinate x € y (in pixel) della posizione del 
cursore del mouse al momento dell'evento (x da sinistra ed y dall'alto), che comunque sono 


anche contenuti nell’oggetto di tipo Event. 
Vedi esempio# 


Quando si parla di tasto del mouse ci si riferisce, nel caso di PC al tasto sinistro e nel caso di 
Macintosh al solo tasto presente sul mouse. Il tasto destro non è considerato in Java per ragioni di 
generalità interpiattaforma (il Mac non l'ha). 


Presentiamo qui di seguito i metodi specifici per gli eventi del mouse. 


Il metodo mouseDown(Event ev, int x, int y) è chiamato ogni volta che il 
bottone sinistro del mouse viene premuto, con il cursore posizionato dentro l'area del componente. 
Come viene detto a proposito del metodo Seguente, non è con questo evento che generalmente si fa 
partire nel programma l'azione conseguente alla pressione di un bottone o ad una scelta di menù; 
con esso invece si fa partire un eventuale comando continuo che deve durare fintantochè il tasto 
resta premuto (per esempio tipicamente la crescita progressiva col tempo di un valore). 
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Il metodo mouseUp (Event ev, int x, int y) èchiamato ogni volta che il bottone 
sinistro del mouse viene rilasciato, con il cursore posizionato dentro l'area del componente. 
Generalmente è con questo evento che si rende operante nel programma l'azione conseguente alla 
pressione di un bottone o ad una scelta di menù, piuttosto che con mouseDown (), perché così si 
permette all'utente di cambiare idea ancora quando ha già premuto il tasto uscendo con il cursore 
fuori del bottone prima di rilasciare il tasto del mouse. 


Il metodo mouseMove (Event ev, int x, int y) è chiamato ogni volta che, con il 
bottone sinistro del mouse sollevato, si muove il cursore dentro l'area del componente spostandosi 
di almeno un pixel in qualsiasi direzione (un evento è generato per ogni pixel di spostamento, per 
cui uno spostamento del cursore di una certa ampiezza scatena una sequenza di eventi di questo 
tipo). 


Il metodo mouseDrag (Event ev, int x, int y) è chiamato ogni volta che, con il 
bottone sinistro del mouse premuto, si muove il cursore dentro l'area del componente spostandosi di 
almeno un pixel in qualsiasi direzione (anche in questo caso un evento è generato per ogni pixel di 
spostamento, per cui anche in questo caso uno spostamento del cursore di una certa ampiezza 
scatena una sequenza di eventi di questo tipo). 


Il metodo mouseEnter (Event ev, int x, int y) è chiamato ogni volta che il 
cursore entra nell'area del componente, con x e y che rappresentano le coordinate del punto di 
entrata. 


Il metodo mouseExit (Event ev, int x, int y) è chiamato ogni volta che il 
cursore esce dall'area del componente, con x e y che rappresentano le coordinate del punto di 
uscita. 


1.4.2.3 Metodi specifici di risposta agli eventi di tastiera 


La battuta di un tasto sulla tastiera da parte dell'utilizzatore costituisce un evento che può essere 
intercettato con il metodo keyDown (Event ev, int tasto), che è chiamato ogni volta che 
viene premuto un tasto mentre l'applet è attiva (questa precisazione è importante perché la battuta 
del tasto non viene captata se l’applet non ha il focus e questo si può ottenere con un clic del mouse 
su di essa). Il sistema passa come argomento a tale metodo il valore ASCII (un intero) del carattere 
relativo al tasto e il carattere corrispondente al valore ASCII può poi essere ottenuto con un cast di 
tipo (char)tasto. 


Esempio:# 


Oltre ai caratteri alfanumerici scrivibili, il tasto può però riferirsi anche ad altri caratteri 
speciali, come il Return, il Tab, le frecce nei vari sensi, etc. Nella classe Event sono definite 
tutta una serie di variabili di classe static (in effetti delle costanti final) che rappresentano 
i valori di tasti speciali (quelli non scrivibili), come: 


Event . HOME, Event .END, Event .UP, Event . DOWN, Event . LEFT, Event . RIGHT. 
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Si noti che, essendo i valori dei tasti degli interi, si prestano ad essere usati in uno switch 
quando si vuole andare a vedere che tasto è stato battuto. 


Esempio:# 


1.4.2.4 Metodi per i tasti Shift, Ctrl e Alt 


I metodi shiftDown(), controlDown() e metaDown() possono essere usati per 
verificare se i tasti rispettivamente di maiuscole (Shift), Control e Alt (Meta in Unix) sono premuti 
nello stesso momento in cui si sta intercettando un certo evento, per esempio su un altro tasto 
(combinazione di più tasti) o su un'operazione del mouse. 


Esempio:# 


1.4.2.5 Metodi relativi al focus su un componente 


Il metodo getFocus() échiamato ogni volta che il 
Il metodo gotFocus() è chiamato ogni volta che il 
Il metodo lostFocus() è chiamato ogni volta che il 


Il metodo hasFocus() restituisce true se il componente ha il focus di tastiera 


1.4.2.6 Eventi dei componenti UI di interazione utente e metodo 
action () 


I componenti di interazione con l’utente (componenti UI) producono degli eventi chiamati 
azioni. La variabile di istanza id dell'oggetto di tipo Event creato e passato ai metodi di 
trattamento degli eventi dal sistema, ha in tal caso il valore di Event -ACTION_EVENT. Eventi 
di questo tipo possono essere intercettati, oltre che con il metodo generale 
handleEvent (Event), anche più specificamente con il metodo action() del contenitore 
del componente interessato all’azione: 


public boolean action(Event ev, Object arg) 


che riceve un primo argomento di tipo Event, che, come per i metodi relativi agli eventi di mouse 
e tastiera, gli viene passato dal sistema e che caratterizza l'evento, ed un secondo argomento che è 
un oggetto tipico di ciascun tipo di componente UI che contiene le informazioni specifiche ritenute 
necessarie per esso. Quest’oggetto può quindi essere di varia natura (cioè di classe diversa) a 
seconda del componente che lo invia, e in particolare: 


- i bottoni (oggetti Button) producono un'azione se sono premuti e inviano come secondo 
argomento al metodo un’informazione sotto forma di una stringa che rappresenta l'etichetta del 
bottone e può servire al suo riconoscimento, 
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- le Checkbox (dei due tipi) producono un'azione quando sono selezionate e il secondo 
argomento passato è sempre true, 


- i menù di tipo Choice o List producono un'azione quando una voce è selezionata e il 
secondo argomento è la voce stessa, cioè la scelta fatta, come stringa, 


- i campi di input di testo di tipo TextField producono un'azione quando l'utente batte il 
tasto Return mentre il TextField ha il focus ed è quindi in stato di edizione, cioè di 
ricevimento dati, 


- 1 menù producono un'azione quando sono selezionati e il secondo argomento passato è il 
MenuItem scelto sotto forma di stringa. 


Poiché il metodo action() può ricevere eventi da componenti diversi bisogna fare una 
verifica sul tipo di oggetto (precisamente la classe) del componente che ha prodotto l'evento e 
questa informazione è riposta nella variabile di istanza target dell'oggetto Event ricevuto 


if (ev.target instanceof Button) 


che precede il blocco di istruzioni relative alle operazioni prodotte dal bottone. Ecco un esempio: 









public boolean action(Event ev, Object arg) { 





if (ev.target instance of Button) { 
/* istruzionil */ 
return true; 










(ev.target instance of TextField) { 
/* istruzioni2 */ 
return true; 









(ev.target instance of Choice) { 
/* istruzioni3 */ 
return true; 









#esempio completo# 


Esempio: 5 bottoni fanno 5 scritte# 


Oppure diversi v.pag.257 del libro# 


Un altro modo per individuare la causa dell’evento, indicato per esempio per riconoscere quale 
di una serie di bottoni ha scatenato l'evento è quello di adoperare sempre la variabile d’istanza 
target di Event, di classe Object e quindi molto generica, che indica appunto il 
componente bersaglio (target), quello cioè sul quale l'evento è avvenuto, ma verificando la sua 
referenza con quella dei vari componenti possibili. Ad esempio: 
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esempio# 


Vedremo (nel paragrafo 8.4.3.#) come nel trattamento degli eventi di tipo 1.1 quest’oggetto è 
sostituito con quello ottenuto dal metodo AWTEvent .getSource (). 


Eventi relativi alle finestre definiti come variabili di classe nella classe Event: 


WINDOW_DESTROY evento prodotto quando una finestra viene chiusa 


WINDOW_EXPOSE evento prodotto quando una finestra coperta viene ripresentata 


WINDOW _ICONIFY evento prodotto quando una finestra è ridotta a icona 
WINDOW_DEICONIFY evento prodotto quando una finestra ridotta a icona è rivisualizzata 


WINDOW_MOVED evento prodotto quando una finestra è spostata sullo schermo 





v. pag.266 del libro per variabili di classe per eventi action, list, scroll# 









ACTION_EVENT evento prodotto da un componente UI 









KEY ACTION evento prodotto da un'azione su un TextField 
LIST_SELECT evento prodotto quando una voce di una List è selezionata 
LIST_DESELECT evento prodotto quando una voce di una List è deselezionata 
SCROLL_ABSOLUTE evento prodotto quando si sposta il cursore di una ScrollBar 







SCROLL LINE_DOWN evento prodotto quando è azionato uno spostamento giù piccolo 







SCROLL_LINE_UP evento prodotto quando è azionato uno spostamento su piccolo 







SCROLL_PAGE_DOWN evento prodotto quando è azionato uno spostamento giù grande 







SCROLL_PAGE_UP evento prodotto quando è azionato uno spostamento su grande 






1.4.2.7 Eventi in componenti annidati uno dentro l’altro 


In caso di componenti annidati uno dentro l’altro un evento (per esempio un clic del mouse) 
viene sempre ricevuto dapprima dal componente più interno coinvolto nell'evento, il quale può 
trattare o no l’evento e lo può poi passare o no al componente più esterno, che lo può a sua volta 
trattare a modo suo o no e può passarlo al componente ancora più esterno e così via fino al 
contenitore principale. Quando in questa catena un componente intercetta un evento due sono i casi 
che si possono verificare: o lo tratta (o no) e tutto finisce Ià, oppure lo tratta (o no) e lo passa al 
contenitore di livello superiore: nel primo caso il metodo (event handler) che tratta l'evento, 
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handleEvent () in generale o altri metodi specifici come quelli di mouse e tastiera, deve 
restituire true e in questo modo l'evento non è più trasmesso in su nella scala gerarchica, e nel 
secondo caso deve restituire false perchè l'evento sia trasmesso al contenitore di livello 
superiore. Ecco la ragione per cui i metodi di trattamento degli eventi (cosiddetti event handler) 
devono restituire tutti un valore booleano. 


Fai esempio con bottone e cerchio blu sotto: x € y non nel primo metodo ma si nel secondo# 


1.4.3 Modello di gestione degli eventi del JDK 1.1 


1.4.3.1 Modello di trattamento degli eventi per delega 


Il modello di gestione degli eventi ha subìto un’evoluzione passando dalla versione JDK 1.0.2 a 
quella JDK 1.1, con il quale è adottato un modello “per delega” in cui i componenti utilizzano una 
classe esterna per la gestione degli eventi. In questo modello gli eventi sono oggetti della classe 
EventObject appartenente al package java.util. 


1.4.3.2 Interfacce “listener” 


Si riportano nei riquadri seguenti le interfacce, contenute nel package java.awt.event, 
“listener” degli eventi particolari, con i loro metodi, il tipo di oggetto rappresentante l’evento che 
ricevono come argomento e l’ indicazione degli eventi in seguito ai quali essi sono invocati. 


ActionListener | (riceve eventi di tipo action) 


actionPerformed (ActionEvent ) se avviene un'action 





AdjustmentListener (riceve eventi di tipo adjustment) 


adj ustment ValueChanged (Adj ustmentEvent) se è cambiato il valore dell'adjustable 





ComponentListener | (riceve eventi di tipo component) 
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componentHidden(ComponentEvent) se un componente è stato nascosto 





componentMoved(ComponentEvent) se un componente è stato mosso 
component Resized (ComponentEvent ) se un componente è stato ridimensionato 
component Shown (ComponentEvent ) se un componente è stato mostrato 


ContainerListener | (riceve eventi di tipo container) 


componentAdded (ContainerEvent ) se un componente è stato aggiunto al contenitore 


componentRemoved(ContainerEvent) se un componente è stato rimosso dal contenitore 





(riceve eventi di tipo "keyboard focus” su un componente) 


focusGained(FocusEvent) se un componente prende il focus di tastiera 


focusLost (FocusEvent ) se un componente perde il focus di tastiera 





ItemListener | (riceve eventi di tipo item) 


itemStateChanged(ItemEvent) se lo stato di un item è stato cambiato 





KeyListener | (riceve eventi di tastiera (keyboard)) 


keyPressed(KeyEvent) se un tasto è stato premuto 


keyReleased(KeyEvent) se un tasto è stato rilasciato 


keyTyped (KeyEvent ) se un tasto é stato battuto 





MouseListener | (riceve eventi di mouse su un componente) 
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mouseClicked(MouseEvent) se il mouse è stato clickato su un componente 










mouseEntered (MouseEvent ) se il cursore del mouse entra in un componente 

mouseExited (MouseEvent ) se il cursore del mouse esce da un componente 

mousePressed (MouseEvent ) se un bottone del mouse é stato premuto su un 
componente 





mouseReleased (MouseEvent ) se un bottone del mouse è stato rilasciato su un 
componente 


MouseMot ionListener (riceve eventi di movimento di mouse su un componente) 


mouseDragged ( MouseEvent ) 
se un bottone del mouse è premuto su un componente e quindi "dragged" 


mouseMoved ( MouseEvent ) 


se il bottone del mouse è Stato mosso su un componente (senza premere 
bottoni) 





TextListener (riceve eventi tipo testo) 


textValueChanged (TextEvent) se il valore del testo è cambiato 





WindowListener (riceve eventi di tipo window) 






windowaActivated|( WindowEvent) se una window è attivata 








windowClosed (WindowEvent) se una window è stata chiusa 
windowClosing (WindowEvent) se una window è in corso di chiusura 
windowDeactivated (WindowEvent ) se una window é de-attivata 
windowDeiconified (WindowEvent ) se una window è de-iconificata 











windowIconi fied (WindowEvent ) se una window è iconificata 
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Smart dt 











windowopened (WindowEvent) se una window è stata aperta 






1.4.3.3 Classi di eventi e Adapter 


ActionEvent (evento di tipo action) 
AdjustmentEvent 
ComponentAdapter 
ComponentEvent 
ContainerAdapter 
ContainerEvent 
FocusAdapter 
FocusEvent 
InputEvent 

ItemEvent 
KeyAdapter 
KeyEvent 
MouseAdapter 
MouseEvent 
MouseMotionAdapter 
PaintEvent 

TextEvent 
WindowAdapter 


WindowEvent 


Esempi 


Ma il ruolo di listener degli eventi di un componente può essere assunto anche dal contenitore 
stesso del componente, se lo si implementa come tale alla definizione e si passa il this come 
argomento al metodo che aggiunge il listener: questo è quanto è stato fatto nell’esempio 7.x.y in cui 
si considera un’applet contenente delle Chekbox facenti parte di un ChekboxGroup, con il 


loro listener di tipo ItemListener, il cui ruolo è assunto dall’applet stessa, e l’evento 


ItemEvent. 





// H17CB.java (F. Spagna) Esempio con contenitore stesso come listener di evento 





import java.awt.*; 
import java.awt.event.*; 
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public class HI7CB extends java.applet.Applet implements ItemListener { 
Label lab = new Label ("zero"); 
String s[] = { "uno", "due", "tre" }: 
CheckboxGroup cg = new CheckboxGroup(); 
Checkbox cb[] = new Checkbox[5]; 
public void init() { 
for (int n= 0; n < 3; n++) { 

cb[n] = new Checkbox(s{n], cg, false); 

addicb[n]); 

cb[n].addItemListener(this); 












} 
lab. setForeground(color.red); 
add(lab); 






} 
public void itemStateChanged (ItemEvent e) { 

Nab: set Text (cg. getSelectedCheckbox() .getLabel ()), 
} 






} 





In figura 8. è riportato l’aspetto dell’applet. 










/f H1l8evbotil. java F.Spagna Esempio di gestione eventi in JDK 1.1 
// 01-16.12.98 (inizio 16 dic 1998) 






import java.awt.*; // per la grafica 
import java.awt.event.+; // per la gestione degli eventi tipo 1.1 













Button bot = new Button("+1"), // con un bottone 












Label lab = new Label("0"),; // con un'etichetta 
int cont = 0; // e avente una variabile contatore 
H18evbot11() { // il costruttore... 
setLayout (new FlowLayout ()); // fissa la disposizione 
add(lab); // aggiunge l'etichetta 
add(bot); // aggiunge il bottone 





bot.addActionListener(new ascoltBot(this)); // e l'ascolto del bottone 





} 

static public void main(String args[]) { // il metodo di partenza 
evbotll app = new evbotll(); / {crea un'istanza di applicazione (Frame) 
app.pack(}; // dimensiona il Frame per contenere gli elementi 
app.show(); // vende visibile il Frame 









} 





} 

Class ascoltBot implements ActionListener { // l'ascoltatore di bottone 
Hl8Sevbotli evb; // contiese una referenza dell'applicazione 
ascoltBot (Hl8evbot11 ap) { Jf all'istanziazione dell'ascoltatore... 

evb = ap; // riceve la referenza all'applicazione come argomento 












} 
public voia actionPerformed (ActionEvent e) { // quando evento action 
evb.lab.setText("» + ++evb.cont); // scrive su etich.dell'applicazione 



















} 






LI Hl9evbotll.java F. Spagna Esempio di gestione eventi in JDK 1.1 
FI 01-16.12.98 (inizio 16 dic 1998) 
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import java.awt.*; // per la grafica 
import java.awt.event.*; // per la gestione degli eventi tipo 1.1 







public class H19evbot11 extends Frame {//applicazione costituita da un Frame 

















Button bot = new Button("+1"); // con un bottone 
Label lab = new Label("0"); // con un'etichetta 
int cont = 0; // e avente una variabile contatore 
H19evbot11() { // il costruttore... 
setLayout (new FlowLayout ()); // fissa la disposizione 
add(lab); // aggiunge l'etichetta 
add(bot); // aggiunge il bottone 
class ascoltBot implements ActionListener { // l'ascoltatore di bottone 
Hl9evbotl1 evb; // contiese una referenza dell'applicazione 
ascoltBot (H19evbotl11 ap) { // all'istanziazione dell'ascoltatore... 
evb = ap; // riceve la referenza all'applicazione come argomento 

} 
public void actionPerformed(ActionEvent e) { // quando evento action 








evb.lab.setText("" + ++evb.cont); // scrive su etich.dell'applicazione 








} 









bot .addActionListener (new ascoltBot(this)); // e l'ascolto del bottone 







} 







static public void main(String args{]) { // il metodo di partenza 
Hl9evbot ll app = new hl9evbot11(); // crea istanza di applicaz. (Frame) 
app.pack(); // dimensiona il Frama per contenere gli elementi 
app. show({); // rende visibile il Frame 





In figura 8. è riportato l'aspetto dell’ applet. 


La maggior parte delle interfacce listener considerano vari sottotipi di eventi, per ciascuno dei 
quali è previsto un metodo astratto da implementare nella classe che implementa quell'interfaccia, 
per esempio MouseListener prevede l'implementazione di mouseClicked(), 
mousePressed(), mouseReleased (), mouseEntered() e mouseExited({). Se 
non si è interessati ad implementare tutti i metodi dell'interfaccia, quelli non importanti sono 
lasciati vuoti, ma questo appesantisce il codice inutilmente: in tal caso per evitare ciò si utilizzano i 
cosiddetti adapter, che sono classi che si occupano di implementare le interfacce con tutti metodi 
vuoti. Così, anzichè implementare (con implemets) l'interfaccia nella classe listener, si fa 
discendere questa (con extend) dal relativo adapter, potendocisi così limitare ad implementare solo 
i metodi necessari con un overriding. 


Gli adapter: 


ComponentAdapter 
ContainerAdapter 
FocusAdapter 
KeyAdapter 
MouseAdapter 
MouseMot ionAdapter 
WindowAdapter 
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Esempio: 


// H20evmouse.java (F.Spagna) Eventi su un bottone con JDK 1.1 
// 01-25.04.99 (inizio 25 aprile 1999) 


import java.awt.*; 
import java.awt.event.*; 


public class H20evmouse extends java .applet.Applet implements MouseListener { 


Label lab; 


public void init() { 
addMouseListener(this); // si mette un ascoltatore a se stessa 
add(lab = new Label("inizio aa D // etichetta per vedere l'effetto 
} 
public void mouseClicked(MouseEvent e) { 
lab.setText("" + e.getX() +", " + e.getY()}); // se premuto mouse 
} 
public void mousePressed(MouseEvent e) {} //metodi senza effetto ma necess. 
public void mouseReleased(MouseEvent e) { } 
public void mouseEntered(MouseEvent e) {} 
public void mouseExited(MouseEvent e) {} 





1.4.3.4 Eventi del mouse 


Esempio di un’ applet che evidenzia con delle scritte i vari eventi del mouse via via che vengono 
rilevati. 











// HOOmouse088.java F.Spagna (inizio 26 agosto 1999) 


se 





// Operazioni con il mouse 
// 01-26.08.99 








import java.awt.*; 
import java.awt.event.*; 









public class H00mouse088 extends java.applet.Applet // la stessa applet 
implements MouseListener, // sente i clic del mouse 
MouseMotionListener { // i suoi movimenti 







int tipoEvento; 
int x, y? 
String s[] = {"pressed", “released", "dragged", "clicked", 
"entered", "exited", "moved" }; 
public void init() { 
addMouseListener (this); // delega l'applet a sentire il mouse 
addMouseMotionListener(this); // delega applet a sentire il movim.mouse 











} 
public void paint(Graphics g) { 
g.drawString(s[tipoEvento], x, y); // disegna secondo rettangolo 







} 
void scrivi(MouseEvent me, int tipoEvento) { 
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this.tipoFvento = tipoEvento; 
x = me.getX(); // coordinate del mouse quando premuto 
Y = me.getY(); 

repaint (); 








} 
public void mousePressed(MouseEvent me) { // quando mouse premuto 
scrivi(me, 0); 






} 
public voia mouseReleased(MouseEvent me) { 
scrivi(me, 1); 








} 

public void mouseDragged (MouseEvent me) { // quando mouse trascinato 
scrivi(me, 2); 

} 





public void mouseClicked (MouseEvent me) { 
scrivi(me, 3); 







} 
public void mouseEntered(MouseEvent me) { 
scrivi(me, 4); 






} 
public void mouseExited (MouseEvent me} { 
scrivi(me, 5); 






} 
public void mouseMoved (MouseEvent me) { 
scrivi(me, 6); 





} 


Nella figura 8.xx si vede l’applet in funzione, 


# 


Figura 8.xx Applet che rileva gli eventi del mouse. 


Un altro esempio interessante puo essere il seguente, che permette la selezione di un’area di 
un’immagine con il mouse. 






// HO OmouseSelez086. java F.Spagna (inizio 14 agosto 1999) 
// Selezione di un'area con il mouse 
// 01-22.08,99 













import java.awt.*; 
import java.awt.event.*; 





public class HOOmouseSelez086 extends java.applet .Applet // la stessa applat 














implements MouseListener, // sente i clic del mouse 
MouseMotionListener { // i suoi movimenti 

Image mappa; // immagine mappa da zoomare 
Image imgMemo; // immagine in memoria 
Graphics gr; // contesto grafico immagine in memoria 
int x0, y0; // coordinate primo punto selezionato 
int x, y; // coordinate secondo punto selezionato 





int x1, yi; // coordinate vertice alto a sinistra rettangolo selezionato 
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int b, h; // base e altezza rettangolo selezionato 
boolean primoPunto = true; // vero se primo punto deve essere selezionato 


public void init() { 


int bas = 300, alt = 200; // dimensioni immagine in memoria 
mappa = getImage(getCodeBase(), "“Italia.gif"); // carica l'immagine 
imgMemo = createImage(bas, alt); // crea immagine in memmoria 
gr = imgMemo.getGraphics(); // contesto garfico immagine in memoria 
gr.drawImage (mappa, 0, 0, this); // disegna l'immagine in memoria 
addMouseListener(this); // delega l'applet a sentire il mouse 
addMouseMotionListener(this); // delega applet a sentire il movim.mouse 
} 
public void paint (Graphics g) { 
g.drawImage(imgMemo, 0, 0, this); // disegna l'immagine reale 
x1 = Math.min(x0, x): yl = Math.min(y0, y);// vertice alto sinistro 
b = Math.abs(x - x0); h= Math.abs(y - y0); // lati solo positivi 
g.setColor(Color.blue); // rettangolo blu 
g-drawRect (x1, yl, b, h); // disegna rettangolo selezionato 
g-drawRect (xi+1, yl+1, b-2, h-2); // disegna secondo rettangolo 
} 


public void update(Graphics g) { 
paint(g); 


} 
public void mousePressed(MouseEvent me) { // quando mouse premuto 
if (primoPunto) { // se il primo punto non ancora selezionato 
x0 = me.getX(); // coordinate del mouse quando premuto 
yO = me.getY(); 
primoPunto = false; // annota la selezione fatta 
} 
} 


public void mouseReleased (MouseFvent me} { 
primoPunto = true; 
} 


public void mouseDragged (MouseEvent me) { // quando mouse trascinato 
x = me.getx(); // coordinate ad ogni istante del mouse trascinato 
y = me.gety(); 
repaint (); // ridisegna immagine e rettangolo selezionato 
} 


public void mouseClicked (MouseEvent me) { // metodi non utilizzati 

public void mouseEntered (MouseEvent me) { 

public void mouseExited (MouseEvent me) { 
{ 


public void mouseMoved (MouseEvent me} 





La figura 8.xx mostra I’ applet durante una selezione. 
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Figura 8.xx Applet con area selezionabile mediante il mouse. 








2.Grafica in Java ed eventi 


2.1 Grafica dell’AWT 


2.1.1 Disegno su un componente senza il metodo paint ( ) 


Per disegnare qualcosa su un componente tipo Panel (e in particolare su un'applet) o su un 
Canvas bisogna avere a disposizione il suo contesto grafico, che è un oggetto di tipo 
Graphics e che può essere considerato come lo strumento di disegno sul componente mediante i 
suoi metodi grafici. Di solito viene adoperato il metodo paint (Graphics) del componente 
cui il sistema passa il contesto grafico come un oggetto di tipo Graphics, ma questo non è 
strettamente necessario, in quanto basterebbe ottenere il contesto grafico del componente con il 
metodo getGraphics() della superclasse Component. Per disegnare per esempio un 
rettangolo le istruzioni sarebbero quindi: 


Graphics g = getGraphics(); 


g.drawRectangle(); 


che possono essere sintetizzate in maniera compatta da un'unica istruzione: 


getGraphics().drawRectangle(); 


nella quale il primo metodo restituisce il contesto grafico di tipo Graphics del componente 
(l'oggetto sul quale si disegna, ad esempio l'applet) con il quale si può disegnare il rettangolo con il 
metodo drawRectangle() proprio della classe Graphics. 


Esempio:# 


Ma senza un metodo paint () questo disegno avviene solo una volta e l'applet non è 
ridisegnata ogni qualvolta una finestra va a ricoprime il disegno e poi lo scopre o quando da parte 
dell'utente vengono cambiate le dimensioni della finestra del browser. 


2.1.2 Disegno con il metodo paint () 


E' con il metodo paint (Graphics) che in un'applicazione in quanto Frame o in 
un'applet in quanto Panel (sia Frame sia Panel ereditano il metodo paint () dalla 
superclasse Component) si disegna generalmente qualcosa sullo schermo ogni volta che ciò 
viene richiesto dalle operazioni che l’utente fa sulle finestre. Questo metodo riceve come 
argomento un oggetto di tipo Graphics (contesto grafico) che gli viene passato dall'interprete, 
che contiene tutte le informazioni grafiche (colore, font, etc.) richieste dal disegno e che possiede i 
metodi che servono per disegnare. 








La classe Graphics del package java.awt dispone di vari metodi (primitive grafiche) 
per la scrittura di stringhe, il disegno di linee e figure geometriche semplici o la riproduzione di 
immagini bitmap (definite punto per punto, cioè pixel per pixel). E’ questa la classe che 
sovraintende a tutte le operazioni di disegno in Java mediante i suoi metodi. 


Il sistema di coordinate di Java ha l'origine nel vertice in alto a sinistra del componente su cui 


si disegna, con valori positivi dell'ascissa x verso destra e dell'ordinata y verso il basso, come è 
rappresentato in figura 9. |. 


Le coordinate vengono espresse in pixel, cioè in numero di punti sullo schermo, mediante 
numeri interi. 


O--------- > X ----------- 
| origine 
| | 
V area del 

Y componente 

| 

| 

| 


Figura 9.1 Sistema di coordinate in Java 


Il colore con cui vengono effettuati i disegni è quello stabilito eventualmente con un'istruzione 


g.setColor(colore); oppure quello di default (cioè il nero) nel caso che non ne sia stato 
precisato alcuno. 


2.1.3 Linee 


Per disegnare un segmento di retta tra due punti la classe Graphics dispone del metodo 
drawLine(), che richiede come argomenti le coordinate dei due punti: 


drawLine(int x1, int yl, int x2, int y2) 


Le linee tracciate con questo metodo, cosi come quelle tracciate dagli altri metodi per disegnare 
altri elementi geometrici, sono sempre di un solo pixel di spessore (nella prima versione di Java 
non c'è la possibilità di cambiare lo spessore delle linee disegnate). 


Esempio pratico in cui viene tracciato un segmento tra il punto (0, 0), cioè il vertice in alto a 
sinistra, e il punto (100, 100) spostato 100 pixel a destra e 100 verso il basso: 





// IOllinea.java {F.Spagna) Esempio di disegno di un segmento tra due punti 





import java.awt.*; 





public class I0llinea extends java.applet.Applet { 






public void paint (Graphics g) { 
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g.drawLine(0, 0, 100, 100); 
} 





In figura 9.16 è riportato il risultato grafico dell’appiet dell’esempio. 


Il metodo drawPolyline (int x[], nt y[], int nPunti) traccia una sequenza 
di segmenti che uniscono una serie di punti definiti dagli array di coordinate x[] e y[]: la spezzata 
non viene chiusa alla fine se il primo e l'utitimo punto non coincidono, 


Esempio#: 


2.1.4 Rettangoli 


Per disegnare un rettangolo la classe Graphics dispone del metodo drawRect (), che 
richiede come argomenti le coordinate x e y del vertice in alto a sinistra e la larghezza e l'altezza 
del rettangolo: 


drawRect (int X, int y, int larghezza, int altezza) 


Il metodo fillRrect () èdel tutto analogo, con la differenza che viene riempito con il colore 
corrente del disegno, 


Per disegnare rettangoli speciali esistono ancora altri metodi come drawRoundRect () per 
disegnare rettangoli con i vertici arrotondati secondo un quarto di ellisse e il corrispondente 
fillRoundRect() che ne fa anche il riempimento con il colore corrente: questi metodi 
richiedono due argomenti supplementari che rappresentano la larghezza e l'altezza totale delle zone 
arrotondate (somma delle due parti lungo lo stesso lato) vicino ai vertici (vedi l’esempio che 
segue). 


Un altro tipo di rettangolo che si può disegnare è quello prodotto dal metodo draw3DRect () 
che presenta un effetto tridimensionale molto rudimentale prodotto da due bordi in luce più chiari e 
due bordi in ombra più scuri. Sono possibili due effetti, quello che fa apparire il rettangolo in 
rilievo (come un bottone sollevato) e quello che lo fa apparire incassato (come un bottone 


Il metodo clearRect () riempie di colore il rettangolo come fillRect (} , usando però il 
colore di fondo corrente anziché quello di disegno (è come se il fondo originario venisse ad essere 
scoperto se era occupato da precedenti disegni). 


Ecco un esempio che comprende diversi rettangoli disegnati con i vari metodi: 


I I02rettangoli.java F.Spagna Disegno di rettangoli 


import Java.awt.*; 
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public class I02rettangoli extends java.applet.Applet { 





public void paint (Graphics g) { 


g.drawRect (20, 25, 60, 50); 
g.fillRect (95, 25, 60, 50); 
g.drawRoundRect (170, 25, 60, 50, 30, 25); 
g. fillRoundRect (245, 25, 60, 50, 30, 25); 
g.setColor(Color.red); 

g.draw3DRect (20, 110, 60, 50, true); 
g.draw3DRect (95, 110, 60, 50, false); 
g.f1113DRect (170, 110, 60, 50, true}; 
g-fi113DRect (245, 110, 60, 50, false); 





Il risultato è quello di figura 9.2. L'effetto di trimensionalità non è sempre evidente dato Io 
spessore del disegno dei bordi, che, essendo sempre di un pixel, è molto sottile. 





Figura 9.2 Disegno di rettangoli vuoti e pieni in vario modo. 


2.1.5 Poligoni 


2.1.5.1 Classe Polygon e creazione di un poligono 


La classe Polygon del package # permette di creare un oggetto che rappresenta un poligono 
definito mediante l'insieme delle coordinate dei suoi vertici. 


La creazione di un poligono può essere fatta o con un costruttore che ricevere i due array di 
ascisse e di ordinate dei vertici, oppure con un costruttore senza argomenti e applicando poi 
ripetutamente per ogni vertice il metodo addPoint (x, y). 


Per esempio la creazione di due poligoni rappresentanti una lettera T con altezza di 200 pixel, 
larghezza di 150 pixel e spessore di 30 pixel ed inizializzati nei due modi detti sopra, si può fare nei 
due modi mostrati dell'esempio del paragrafo seguente. 
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2.1.5.2 Disegno di un poligono 


Per disegnare un poligono può essere usato il metodo drawPolygon() di Graphics che 
può ricevere o l'una o l'altra delle seguenti liste di argomenti: 


- un array di ascisse x[], un array di ordinate y[] e il numero di vertici, 


- un oggetto di tipo Polygon già opportunamente istanziato nel modo spiegato nel paragrafo 
precedente. 


Esiste anche una versione £illPolygon() per disegnare il poligono riempito con il colore 
corrente. 


Con il metodo drawPolygon({) il poligono non viene chiuso automaticamente se il primo e 
l'ultimo vertice non coincidono: per farlo chiudere bisogna aggiungere ai suoi vertici un ultimo 
punto uguale al primo. Questo non è necessario con il metodo fillPolygon({) che fa la 
chiusura automaticamente (e non potrebbe essere altrimenti dato che deve essere fatto il 
riempimento). 


Nell'esempio seguente sono disegnati due poligoni, uno vuoto (che non è chiuso) ed uno pieno, 
e sono stati adoperati i due modi di definizione dei vertici: nel primo caso passando l’array dei 
vertici come argomento del costruttore e nel secondo caso adoperando ripetutamente il metodo 
add{) (ci si perdoni la piccola operazione di inversione fatta sulle ordinate per rovesciare la 


figura). 





// I03poligoni.java {F.Spagna) Disegno di poligoni 






import java.awt.*; 












public class I03poligoni extends java.applet.Applet { 











int x{] = { 20, 170, 170, 110, 110, 80, 80, 20}; 
int y[] = { 20, 20, 50, 50, 170, 170, 50, 50}; 
Polygon Tvuoto new Polygon(x, y, x.length); 

Polygon Tpieno new Polygon(): 













public void init() { 
for (int n= 0; n< x.length; n++) 
Tpieno.addPoint(x[n]+130, 200 - y[n]}); 











} 

public void paint (Graphics g) { 
g.drawPolygon(Tvuoto); 
g.fillPolygon(Tpieno); 







} 


Il risultato del disegno è riportato in figura 9.3. 
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Figura 9.3 Disegno di un poligono vuoto e di uno pieno. 


2.1.6 Ellissi o cerchi 


Un'ellisse viene disegnata con il metodo drawoval () di Graphics che riceve gli 
argomenti che si dovrebbero dare per il disegno del rettangolo in cui l'ellisse è inscritta Per ben 





Vai I0dellissi.java F. Spagna Disegno di ellissi 





import java.awt.* ; 
Public class I04ellissi extends Java .applet.Applet { 
Public void paint (Graphics g) { 
g.drawOval (20, 20, 120, 70); 
g.drawRect (20, 20, 120, 70); 


g.filloval(160, 20, 120, 70); 
g.drawRect (160, 

















2.1.7 Archi di ellisse o di cerchio 


Il disegno di archi di ellisse e quindi, come caso particolare, anche degli archi di cerchio, può 
essere fatto con il metodo drawArc() di Graphics. Per quanto riguarda gli argomenti 
richiesti da questo metodo bisogna ricordare innanzi tutto i quattro argomenti richiesti dal metodo 
drawOval (), che per gli archi di ellisse sono definiti nello stesso modo con riferimento all'ellisse 
completa di cui l'arco fa parte (cioè le coordinate del vertice in alto a sinistra e base e altezza del 
rettangolo in cui si può inscrivere l'ellisse). Ci sono poi da aggiungere due altri parametri che 
indicano il primo l'angolo di inizio dell'arco rispetto all'asse orizzontale dell'ellisse a partire dalla 
posizione di una lancetta di orologio indicante le ore tre, e il secondo l'angolo da percorrere per 
arrivare alla fine dell'arco (apertura dell'arco), essendo l'angolo iniziale e l'apertura dell'angolo 
considerati positivi andando in senso antiorario e gli angoli essendo espressi in gradi (sono accettati 
anche valori negativi che vanno in senso orario). 


Il metodo fillArc() segue le stesse regole per gli argomenti, salvo che riempie del colore 
corrente tutto lo spicchio di ellisse relativo all'arco (a guisa di una fetta di torta). Facciamo un 
esempio, in cui sono disegnati, per fissare meglio le idee, anche i rettangoli in cui l'ellisse è 
inscritta: 


// I05archi. java F.Spagna Disegno di archi di ellisse 


import java.awt.*; 
public class I0Sarchi extends java.applet.Applet { 
public void paint {Graphics g} { 


g.@rawArc(20, 20, 120, 70, 0, 90); 
g.drawRect (20, 20, 120, 70); 
g.fillArc(160, 20, 120, 70, 0, 90); 
g.drawRect (160, 20, 120, 70); 
g.drawArc(20, 110, 120, 70, 90, 270); 
g.drawRect (20, 110, 120, 70); 
g.fillArc(160, 110, 120, 70, 90, 270); 
g.drawRect (160, 110, 120, 70); 





Il risultato è riportato in figura 9.5. 
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Figura 9.5 Disegno di archi di ellisse vuoti e pieni (in alto partenza da 0° e angolo di apertura di 
90° e in basso partenza da 90° e angolo di apertura di 270°), 


2.1.8 Scrittura di stringhe 


Per scrivere una stringa su un componente grafico si può usare, oltre che un componente di tipo 
Label (a questo proposito vedi il paragrafo 7.2.1), anche il metodo drawString() di 
Graphics. Ma prima, se non ci gi vuole limitare ad usare il font che il sistema adotta di default, 
bisogna fissare il font scelto per le scritte con il metodo setFont (Font) del componente sul 
quale si deve scrivere, oppure lo stesso metodo, ma del suo contesto grafico Graphics. 


Per esempio: 


Font f = new Font (“TimesRoman”, Font. PLAIN, 14); 
g-setFont (£); 


O, più sinteticamente: 


9.s8etFont (new Font (“TimesRoman”, Font . PLAIN, 14)); 


Si riporta qui un esempio che utilizza in una serie di scritte vari font. Il risultato è presentato in 
figura 9.7, 
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// I06stringhe.java (F.Spagna) Disegno di archi di ellisse 
import java.awt.*; 
public class I06stringhe extends java.applet.Applet { 


public void paint (Graphics g) { 


for {int i = 0; i < 12; i++} { 
g.setFont {new Font ("TimesRoman", Font.PLAIN, 10+2*i))}; 
g.drawString("TimesRoman"+(10+2*1), 20, 30 + 25*i); 


} 

for (int i = 0; i < 12; i++) { 
g.setFont (new Font ("TimesRoman", Font.BOLD, 10+2*i)); 
g.drawString("bold", 225, 30 + 25*i); 

} 

for (int i = 0; i < 12; i++) { 
g.setFont (new Font ("TimesRoman", Font..ITALIC, 10+2*i)); 
g.drawString("italic", 295, 30 + 25*i); 

} 

for (int i = 0; i < 12; i++) { 
g.setFont (new Font ("Courier", Font.PLAIN, 10+2*i)}); 
g.drawString("Courier", 372, 30 + 25*i); 

} 

for (int i = 0; i < 12; i++) { 
g.setFont (new Font ("Helvetica", Font.PLAIN, 10+2*i)); 
g-drawString("Helvetica", 513, 30 + 25*i); 










: TimesRoman 
TimesRoman 16 





Figura 9.7 Scritte di stringhe con vari tipi di font e dimensioni diverse. 
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Un metodo alternativo per scrivere una serie di caratteri sullo schermo è il drawChars() 
che riceve però come argomenti non una stringa bensì un array di caratteri, che è un tipo di oggetto 
diverso, ed ha ancora altri due argomenti con i quali si possono precisare gli indici all’interno 
dell'array del primo e dell'ultimo carattere da scrivere, essendo scritti tutti i caratteri compresi tra i 
due. 


Esempio: 


# 


2.1.9 Immagini 


2.1.9.1 Classe Image 


La classe Image del package java.awt permette di creare ed usare oggetti che 
rappresentano un'immagine e dispongono di vari metodi per il suo trattamento. 


La classe Applet presenta un metodo per caricare un'immagine e la classe Graphics ha 
un metodo per disegnare un'immagine sullo schermo. 


2.1.9.2 Caricamento di un'immagine 


Prima di essere utilizzata in un'applet un'immagine deve essere caricata attraverso la rete come 
file a partire dal server dell'applet mediante il metodo getImage() della classe Applet che 
carica sulla macchina client l'immagine da un determinato server e ne crea un'istanza disponibile 
per il programma. Il metodo può ricevere come argomento l'URL dell'immagine (come oggetto di 
tipo URL), comprendente la directory ed il nome del file immagine: 


Image img = getImage(URL); 


Un esempio potrebbe essere: 


Image img = getImage (new URL (http: //www.server.it/immagini/immagine.gif)); 


Ma una forma alternativa del metodo, che è preferibile perchè più flessibile, prevede due 
argomenti separati, uno per l'URL del server (oggetto di tipo URL) e l’altro per il nome del file di 
immagine preceduto dalla directory all'interno del server relativa a quella contenente il documento 
HTML (una stringa). 


Per definire l'URL del file HTML che la richiama, un'applet ha, in quanto appartenente alla 
classe Applet, a disposizione il metodo getDocumentBase () che restituisce l'URL della 
directory contenente il documento HTML come oggetto di tipo URL, ma dispone anche del 
metodo getCodeBase() che restituisce l'URL della directory contenente invece l'applet, che 
può in generale essere diversa da quella dell'HTML (ciò quando è precisato un codebase nel 
tag <applet>, secondo quanto detto al paragrafo 5.4.2). L'uso dell'uno o dell'altro metodo 
dipende dalla localizzazione del file immagine (nella directory del file HTML che richiama l'applet 
o in quella del file .class costituente l'applet stessa). Qundi nei due casi: 
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getImage(getDocumentBase(), “immagine.gif”); 


Image img 


oppure: 


getImage (getCodeBase(), “immagine.gif”); 


Image img 


Nel caso di animazioni che comprendono molte immagini di solito queste vengono poste in una 
sottodirectory a parte sotto la directory contenente l'applet. Se ad esempio una tale sottodirectory si 
chiamasse immagini, si scriverebbe: 


Image img = getImage(getCodeBase(), “immagini/immagine.gif”); 


Se il programma richiede un'immagine e non la trova esso non ne fa un dramma e viene eseguito 
lo stesso, ma senza evidentemente che l'immagine possa essere vista. 


I formati di immagini accettati da Java al momento sono solo il GIF ed il JPEG, che sono poi 
quelli attualmente riconosciuti dai browser per Internet. 


Fuori da un’ applet un'immagine può essere caricata anche con: 


Image img = Toolkit.getDefaultToolkit ().getImage(nomefilenaOppureURL) ; 


Esempio: 


// I00toolkit.java F.Spagna Immagine caricata in un'applicazione Java 


import java.awt.*; 
import java.awt.event.*; 


public class I00toolkit extends Frame { 
static Image mappa; // immagine mappa da zoomare 


IOOtoolkit() { 
mappa = Toolkit.getDefaultToolkit().getImage("Italia.gif"); 
} 
public void paint (Graphics g) { 
g.drawImage (mappa, Ò, 0, this); // disegna l'immagine reale 
} 
public static void main(String s[]) { 


IOQtoolkit fr = new I00toolkit(); 
fr.pack(); 
fr.setVisible(true); 





2.1.9.3 Riproduzione di un'immagine 


Per riprodurre un'immagine su un componente si può utilizzare il metodo drawImage ( ) 
della classe Graphics, avente come argomenti l'immagine stessa come oggetto di tipo Image, 
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le coordinate x e y del vertice in alto a sinistra (come quelle del disegno di un rettangolo, per 
intenderci) e la referenza del componente stesso (questa espressa con this). Ad esempio: 


g.drawImage(img, 10, 10, this); 


Nel caso nel disegno si vogliano dare all'immagine delle dimensioni diverse da quelle originali 
sì può ricorrere ad un metodo overloaded del precedente che prevede altri due argomenti, che sono 
la nuova larghezza e la nuova altezza dell'immagine da disegnare, assegnati indipendentemente 


g.drawImage (img, x, Y, largh, alt, this); 


Se nel cambiare le dimensioni di un'immagine si vogliono riferire Je dimensioni a quelle 
originali si possono utilizzare i metodi getWidth(this) e getHeight (this) della 
classe Image, che rilevano rispettivamente la larghezza e l'altezza dell'immagine originale, e poi 
rapportare le dimensioni del disegno ad esse (vedi l'esempio che segue). Il ridimensionamento 
dell'immagine, sia riducendola sia ingrandendola, può produrre un peggioramento della sua qualità. 
Se poi i due lati sono modificati in misura diversa, cioà se il rapporto dei lati è diverso da quello 
originario, l'immagine risulta evidentemente deformata. 


A proposito dell'argomento di getWidth(this) e getHeight (this) diciamo qui 
soltanto che il parametro che i due metodi si aspettano è un oggetto di tipo ImageObserver, 
che cioè implementa quell'interfaccia che ha a che fare con il processo di caricamento 
dell'immagine (permette di conoscere a che punto si è nel processo di caricamento) e che il più 
delle volte può essere rappresentato dal this, cioè il componente stesso su cui si disegna. La 
stessa cosa vale per il this adoperato come ultimo parametro nel metodo drawImage () 
della classe Graphics. 


Esempio in cui un'immagine GIF viene riprodotta in un’applet una volta in grandezza reale e 
una seconda volta anche con dimensioni ridotte della metà. 





1 I07immagine.java (F.Spagna)Riproduzione di immagini in scala reale e ridotta 






import java.awt.*; 


public class 107immagine extends java .applet.Applet { 





Image im; 
public void init() { 
im = getImage(getCodeBase(), "aereo.gif"); 







} 
public void paint (Graphics g) { 
g.drawImage(im, 10, 10, this); 
o-drawimage (im, 220,150, img.getWidth (this) /2, img. getHeight (this)/2,this): 









} 


Il risultato è riprodotto in figura 9.8. 
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Figura 9.8 Disegno su un'applet di un'immagine normale ed una ridotta. 


2.1.9.4 Trattamento delle immagini 


Il package java.awt.Image (da non confondere con il package java.awt che contiene 
la classe Image) contiene delle classi e delle interfacce utili per il trattamento delle immagini 
mediante operazioni sui bit e sui colori. 


2.1.10 Copia di un'area di disegno 


Mediante il metodo copyArea() della classe Graphics è possibile copiare con il suo 
contenuto grafico da un posto ad un altro dell’area di disegno un'intera area rettangolare già 
disegnata. La lista dei parametri da passare al metodo comprende i quattro soliti parametri di un 
rettangolo, che è quello dell’area da copiare (le coordinate del vertice in alto a sinistra, la larghezza 
e l'altezza) e in più lo spostamento orizzontale e lo spostamento verticale rispetto alla posizione 
originale. 


g.copyArea(int x, int y, int bas, int alt, int dx, int dy); 


2.1.11 Icoloriin Java 


2.1.11.1 La classe Color 


La classe Color serve per gestire il colore in Java. Un determinato colore pud essere 
rappresentato da un oggetto di questa classe. Java prende in considerazione colori definiti con 24 
bit, cioè con 8 bit per ciascuna delle tre componenti fondamentali del colore (rosso, verde e blù), 
con valori quindi che possono andare da 0 a 255 per ogni componente e la conseguente possibilità 
di trattare un numero totale di 256 * colori (oltre 16 milioni di colori). 


Però il sistema che ospita l'applicazione o l'applet e i browser al momento generalmente non 
supportano che un valore molto inferiore di colori (spesso anche solo 256) e allora viene fatta una 
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mappatura di corrispondenze di colori su un numero di colori molto più limitato di quelli teorici, 
oppure viene fatto un dithering (colori composti con una mescolanza di singoli pixel di colori 
diversi) secondo la scelta che è stata fatta nel sistema operativo e nel browser utilizzato. 


2.1.11.2 Colori predefiniti e altri colori 


Nella classe Color c'è un certo numero di colori, quelli più comuni, predefiniti come membri 
di classe (variabili statiche costanti), e quindi usabili direttamente in nome della classe senza dover 
istanziare uno specifico oggetto, che sono: 


Color.black, Color.blue, Color.cyan, Color.darkGray, Color.gray, Color.green, Color.lightGray, 
Color.magenta, Color.orange, Color.pink, Color.red, Color.white, Color.yellow 


Per altri colori si può istanziare un oggetto della classe Color inizializzato in vario modo, per 
esempio con i valori interi (compresi tra 0 e 255) delle tre componenti fondamentali (rosso, verde e 
blù) del colore voluto. 


Color c = new Color(int red, int green, int blue); 
Esiste anche un costruttore alternativo che riceve le tre componenti come numeri in virgola 
mobile compresi tra 0.0 e 1.0. 


Nel package java.awt sono anche definiti dei colori in relazione a quelli del 
browser:(vedi#) 


editableText, menuBack, menuBright, menuDim, menuFore, menuHighlight, readOnlyText. 


Esempio:# 


La classe SystemColor dell'AWT, derivata da Color, permette di rilevare i colori dei vari 
componenti grafici dell'interfaccia utente del sistema in uso, attraverso i valori di una serie (25 in 
tutto) di variabili statiche di classe che restituiscono i colori in termini di istanze della classe 
Color. 


Il programma seguente (un'applet) va a vedere i vari colori per un sistema Windows (con colori 
standard) e ne presenta per ognuno un'etichetta di quel colore sull'applet. 


// I08colori.java (F.Spagna) Colori dei vari componenti di sistema 


import java.awt.*; 
public class I08colori extends java.applet.Applet { 


static Color colore[] = { 
SystemColor.desktop, 
SystemColor.activeCaption, 
SystemColor.activeCaptionText, 
SystemColor.activeCaptionBorder, 
SystemColor.inactiveCaption, 





77 









SystemColor.inactiveCaptionText, 
SystemColor.inactiveCaptionBorder, 


SystemColor.window, 
SystemColor.windowBorder, 
SystemColor.windowText, 
SystemColor.menu, 
SystemColor.menuText, 
SystemColor.text, 
SystemColor.textHighlight, 
SystemColor.textHighlightText, 
SystemColor.textInactiveText, 
SystemColor.textText, 
SystemColor.control, 
SystemColor.controlText, 
SystemColor.controlHighlight, 
SystemColor.controlLtHighlight, 
SystemColor.controlShadow, 
SystemColor.controlDkShadow, 
SystemColor.info, 
SystemColor.infoText 

3 

static String elem[] = { 
"desktop", 
"activeCaption”, 
"activeCaptionText", 
“activeCaptionBorder", 
"inactiveCaption", 
"inactiveCaptionTaxt", 
"inactiveCaptionBorder", 
"window", 
"windowBorder", 
“windowText", 
"menu", 
"menuText", 
"text", 
"textHighlight", 
"textHighlightText”, 
"textInactiveText", 
"textText", 
"control", 
"controlText", 
"controlHighlight”", 
"controlLtHighlight", 
“controlShadow", 
*“controlDkShadow", 
"info", 
"infoText" 

}3 

public void init() { 
setLayout (new GridLayout (colore.length, 2)); 
for (int n= 0; n< colore.length; n++) { 

Label 11 = new Label("" +n +"; " + elemi{n]); 























































add(11); 
Label 12 = new Label(" "); 
12.setBackground(colore[n] }; 






add(12); 
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In figura 9.9 si può vedere il risultato di una tale applet. 


D: desktop 

“1: activeCaption 

2: activeC aptionText 
‘3: activeCaptianBorder 
4: inactiveCaption 

5: inactiveCaptionText 
&: inactiveCaptionBarder 
7 window 

8: windowBorder 

9: windowText 

10: menu 

11: menuTexd 

12: text 

13: textHighlight 

14: textHighlightText 
18: textinactiveTaxt 
16: textText 

17: contrat 

18: controlText 

19: contro!Highlight 
‘20: controlLtHighlight 
21: contralShadaw 
:22: contralDkShadow 
23: info 


24: infoTex ana, 


Figura 9.9 Applet che rileva i colori del sistema. 





2.1.11.3 Colori correnti in un contesto grafico e in un componente 


La classe Graphics prevede un metodo setColor() per stabilire il colore corrente di 
ogni disegno (figure geometriche) o scritta (stringhe) che venga fatto con quel contesto grafico. Per 
esempio con: 


g.setColor(Color.red); 


tutti i disegni e le scritte che seguono questa istruzione sono fatti in rosso. 


Ma si può anche fissare il colore del disegno (foreground) e il colore di fondo (background) per 
il componente (oggetto di classe Component) su cui si disegna, con i metodi del componente 
(cioè della sua classe) setForeground(Color) e setBackground(Color) {vedi 
anche il paragrafo 7.1.5). Si osservi a questo proposito che, dato un componente (oggetto) su cui si 
fanno delle operazioni grafiche, si possono fissare le caratteristiche di disegno, come anche quelle 
del font, sul componente stesso (in un'applet generalmente nel suo metodo init ()) oppure 
assegnare le specificazioni grafiche all'oggetto Graphics che viene passato al componente nel 
metodo paint (Graphics). Tra i due sistemi prevale quello che assegna il colore di disegno al 
componente, così che per esempio si può cambiare di colpo il colore di ogni cosa disegnata sul 
componente con una sola istruzione di tipo setForeground (Color). 


Esempio:# 
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Per default il colore di fondo di ogni componente è il grigio in una tonalità media. 


2.1.11.4 Operazioni sui colori 


Se si vuole creare una gamma di colori tutti con la stessa saturazione e la stessa luminosita, ma 
con tinta diversa dall’uno all’altro basta variare il parametro hue nel metodo seguente, lasciando 
costanti gli altri due:(vedi#) 


getHSBColor(hue, saturation, brightness) 


Esempio: 


// I00hue. java F.Spagna Colori con hue variabile 


import java.awt.*; 


or 


Pa 


public class I00hue extends java.applet.Applet { 


public void paint (Graphics g} { 
for (int i = 0; i < 256; i++) 
for (int n = 0; n < 256; n++) { 
g.setColor(Color.getHSBColor((float)(n/256.), (float)(1/256.), 0.8£)); 
g.drawLine(n, 2*i, n, 2*i+1); 





2.1.11.5 Una tabella di colori 


Riportiamo qui una tabella di colori che è presente nei sistemi UNIX sotto forma di un file 
chiamato rgb.tx, pensando che possa essere di qualche utilità quando si lavori con i colori. 


255 250 250 Snow 

248 248 255 ghost white 
248 248 255 Ghostwhite 
245 245 245 white smoke 
245 245 245 WhiteSmoke 
220 220 220 gainsboro 


255 250 240 floral white 
255 250 240 FloralWhite 
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253 


old lace 
OldLace 

linen 

antique white 
AntiqueWhite 
papaya whip 
PapayaWhip 
blanched almona 
BlanchedAlmond 
bisque 

peach puff 
PeachPuff 
navajo white 
NavajoWhite 
moccasin 
cornsilk 

ivory 

lemon chiffon 
LemonChiffon 
seashell 
honeydew 

mint cream 
MintCream 

azure 

alice blue 
AliceBlue 
lavender 
lavender blush 
LavenderBlush 
misty rose 
MistyRose 

white 

black 

dark slate gray 
DarkSlateGray 
dark slate grey 
DarkSlateGrey 
dim gray 
DimGray 

dim grey 
DimGrey 

slate gray 
SlateGray 

slate grey 
SlateGrey 

light slate gray 
LightSlateGray 
light slate grey 
LightSlateGrey 
gray 

grey 

light grey 
LightGrey 

light gray 
LightGray 
midnight blue 
MidnightBlue 
navy 

navy blue 
NavyBlue 
cornflower blue 
CornflowerBlue 
dark slate blue 
DarkSlateBlue 
slate blue 
SlateBlue 
medium slate blue 
MediumSlateBlue 
light slate blue 
LightSlateBlue 
medium blue 
MediumBlue 
royal blue 
RoyalBlue 
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144 
144 
LS 
191 
206 
206 
206 
206 
130 
130 
196 
196 
216 
216 
224 
224 
238 


206 
206 
209 
209 
224 
255 
255 
255 
158 
158 
205 
205 
255 
100 
100 
107 
107 
188 
188 
139 
139 
179 
179 
178 
178 
251 
251 
255 
255 
252 
252 
255 
255 
250 
250 
255 
255 
205 
205 
205 
205 
139 
139 
142 
142 
183 
183 
230 
232 
232 
250 
250 
255 
255 
255 





blue 
dodger blue 
DodgerBlue 

deep sky blue 
DeepSkyBlue 

sky blue 

SkyBlue 

light sky blue 
LightSkyBlue 
steel blue 
SteelBlue 

light steel blue 
LightSteelBlue 
light blue 
LightBlue 

powder blue 
PowderBlue 

pale turquoise 
PaleTurquoise 
dark turquoise 
DarkTurquoise 
medium turquoise 
MediumTurquoise 
turquoise 

cyan 

light cyan 
LightCyan 

cadet blue 
CadetBlue 
medium aquamarine 
MediumAquamarine 
aquamarine 

dark green 
DarkGreen 

dark olive green 
DarkOliveGreen 
dark sea green 
DarkSeaGreen 

sea green 
SeaGreen 

medium sea green 
MediumSeaGreen 
light sea green 
LightSeaGreen 
pale green 
PaleGreen 

spring green 
SpringGreen 

lawn green 
LawnGreen 

green 

chartreuse 
medium spring green 
MediumSpringGreen 
green yellow 
GreenYellow 

lime green 
LimeGreen 

yellow green 
YellowGreen 
forest green 
ForestGreen 
Olive drab 
OliveDrab 

dark khaki 
DarkKhaki 

khaki 

pale goldenrod 
PaleGoldenrod 
light goldenrod yellow 
LightGoldenrodyellow 
light yellow 
LightYellow 
yellow 
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gold 

light goldenrod 
LightGoldenrod 
goldenrod 
dark goldenrod 
DarkGoldenrod 
rosy brown 
RosyBrown 
indian red 
IndianRed 
saddle brown 
SaddleBrown 
sienna 

peru 
burlywood 
beige 

wheat 

Sandy brown 
SandyBrown 
tan 

chocolate 
firebrick 
brown 

dark salmon 
DarkSalmon 
salmon 

light salmon 
LightSalmon 
orange 

dark orange 
DarkOrange 
coral 

light coral 
LightCoral 
tomato 

orange red 
OrangeRed 

red 

hot pink 
HotPink 

deep pink 
DeepPink 

pink 

light pink 
LightPink 
pale violet red 
PaleVioletRed 
maroon 

medium violet red 
MediumVioletRed 
violet red 
VioletRed 
magenta 
violet 

plum 

orchid 
medium orchid 
Mediumorchid 
dark orchid 
DarkOrchid 
dark violet 
DarkViolet 
blue violet 
BlueViolet 
purple 

medium purple 
MediumPurple 
thistle 

snowl 

snow2 

snow3 

snow4 
seashelll 
seashel1l2 
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135 
126 
108 
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191 
178 
154 
104 
206 
192 
166 
112 


191 


219 
204 
176 
120 
196 
183 


107 
185 
173 
149 
101 
173 
161 
139 


205 
191 
165 
112 
220 
205 
177 
120 
240 
224 


131 
240 
224 
193 
131 
245 
229 
197 
134 
225 
210 
181 
123 


238 
205 
139 
255 
238 
205 
139 
255 
238 


139 
255 
238 
205 
139 
255 


205 
139 
255 
238 


139 
255 
238 
205 
139 
255 
238 
205 
139 


seashell3 
seashell14 
AntiqueWhitel 
AntiqueWhite2 
AntiqueWhite3 
AntiqueWhite4 
bisquel 
bisque2 
bisque3 
bisque4 
PeachPuffl 
PeachPuf £2 
PeachPuff3 
PeachPuff4 
NavajoWhitel 
Navajowhite2 
Navajowhite3 
NavajoWhite4 
LemonChiffon1 
LemonChiffon2 
LemonChiffon3 
LemonChiffon4 
cornsilkil 
cornsilk2 
cornsilk3 
cornsilk4 
ivoryl 

ivory2 

ivory3 

ivory4 
honeydewl 
honeydew2 
honeydew3 
honeydew4 
LavenderBlush1 
LavenderBlush2 
LavenderBlush3 
LavenderBlush4 
MistyRosel 
MistyRose2 
MistyRose3 
MistyRose4 
azurel 

azure2 

azure3 

azure4 
SlateBluel 
SlateBlue2 
SlateBlue3 
SlateBlue4 
RoyalBluel 
RoyalBlue2 
RoyalBlue3 
RoyalBlue4 
bluel 

blue2 

blue3 

blue4 
DodgerBluel 
DodgerBlue2 
DodgerBlue3 
DodgerBlue4 
SteelBluel 
SteelBlue2 
SteelBlue3 
SteelBlue4 
DeepSkyBluel 
DeepSkyBlue2 
DeepSkyBlue3 
DeepSkyBlue4 
SkyBlue1 
SkyBlue2 
SkyBlue3 
SkyBlue4 


84 





176 226 255 LightSkyBluel 


164 211 238 LightSkyBlue2 
141 182 205 LightSkyBlue3 
96 123 139 LightSkyBlue4 
198 226 255 SlateGrayl 

185 211 238 SlateGray2 

159 182 205 SlateGray3 

108 123 139 SlateGray4 

202 225 255 LightSteeiBluel 
188 210 238 LightSteelBlue2 
162 181 205 LightSteelBlue3 
110 123 139 LightSteelBlue4 
191 239 255 LightBluel 


178 223 238 LightBlue2 
154 192 205 LightBlue3 
104 131 139 LightBlue4 
224 255 255 LightCyanl 
209 238 238 LightCyan2 


180 205 205 LightCyan3 
122 139 139 LightCyan4 
187 255 255 PaleTurquoisel 
174 238 238 PaleTurquoise2 
150 205 205 PaleTurquoise3 
102 139 139 PaleTurquoise4 
152 245 255 CadetBluel 


142 229 238 CadetBlue2 
122 197 205 CadetBlue3 


83 134 139 CadetBlue4 

0 245 255 turquoisel 

0 229 238 turquoise2 

O 197 205 turquoise3 

O 134 139 turquoise4d 

0.255 255 cyanl 

O 238 238 cyan2 

0 205 205 cyan3 

O 139 139 cyan4 
152 255 255 DarkSlateGrayl 
141 238 238 DarkSlateGray2 
121 205 205 DarkSlateGray3 
82 139 139 DarkSlateGray4 
127 255 212 aquamarinel 
118 238 198 aquamarine2 
102 205 170 aquamarine3 
69 139 116 aquamarine4 
193 255 193 DarkSeaGreenl 
180 238 180 DarkSeaGreen2 
155 205 155 DarkSeaGreen3 
105 139 105 DarkSeaGreen4 
84 255 159 SeaGreen1 

78 238 148 SeaGreen2 

67 205 128 SeaGreen3 

46 139 87 SeaGreen4 
154 255 154 PaleGreenl 
144 238 144 PaleGreen2 
124 205 124 PaleGreen3 

84 139 84 PaleGreen4 

0 255 127 SpringGreenl 

O 238 118 SpringGreen2 

O 205 102 SpringGreen3 

O 139 69 SpringGreen4 

0 255 0 greenl 

0 238 Q green? 

O 205 0 green3 

O 139 0 greend 
127 255 0 chartreusel 
118 238 0 chartreuse2 
102 205 0 chartreuse3 
69 139 0 chartreuse4 
192 255 62 OliveDrab1 


179 238 58 OliveDrab2 
154 205 50 OliveDrab3 
105 139 34 OliveDrab4 
202 255 112 DarkOliveGreen1 
188 238 104 DarkOliveGreen? 


85 





DarkOliveGreen3 
DarkOliveGreen4 
khakil 

khaki2 

khaki3 

khaki4 
LightGoldenrogi 
LightGoldenrod2 
LightGoldenrodg3 
LightGoldenrod4 
LightYellow1 
LightYellow2 
LightYellow3 
LightYellow4 
yellowl 
yellow2 
yellow3 
yellow4 

goldl 

gold2 

gold3 

gold4 
goldenrodl 
goldenrod2 
goldenrod3 
goldenrod4 
DarkGoldenrodi 
DarkGoldenrod2 
DarkGoldenrod3 
DarkGoldenrod4 
RosyBrownl 
RosyBrown2 
RosyBrown3 
RosyBrown4 
IndianRed1 
IndianRed2 
IndianRed3 
IndianRed4 
siennal 
sienna2 
sienna3 
sienna4 
burlywood1 
burlywood2 
burlywood3 
burlywood4 
wheat1 

wheat2 

wheat3 

wheat4 

tanl 

tan2 

tan3 

tan4 
chocolatel 
chocolate? 
chocolate3 
chocolate 
firebrickl 
firebrick2 
firebrick3 
firebrick4 
browni 

brown2 

brown3 

brownd 

salmoni 
salmon2 
salmon3 
salmon4 
LightSalmonl 
LightSalmon2 
LightSalmon3 
LightSalmon4 
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orangel 
orange? 
orange3 
orange4 
DarkOrangei 
DarkOrange2 
DarkOrange3 
DarkOrange4 
corali 

coral2 

coral3 

coral4 
tomato] 
tomato2 
tomato3 
tomatod 
OrangeRed1 
OrangeRed2 
OrangeRed3 
OrangeRed4 
redl 

red2 

red3 

red4 
DeepPink1 
DeepPink2 
DeepPink3 
DeepPink4 
HotPink1 
HotPink2 
HotPink3 
HotPink4 
pinki 

pink2 

pink3 

pink4 
LightPink1 
LightPink2 
LightPink3 
LightPink4 
PaleVioletRed1 
PaleVioletRed? 
PaleVioletRed3 
PaleVioletRed4 
maroonil 
maroon2 
maroon3 
maroon4 
VioletRed1 
VioletRed2 
VioletRed3 
VioletRed4 
magental 
magenta2 
magenta? 
magenta4 
orchidl 
orchid2 
orchid3 
orchida 

pluml 

Plum2 

Plum3 

Plum4 
MediumOrchid1 
MediumOrchiq2 
MediumOrchid3 
MediumOrchid4 
DarkOrchid1 
DarkOrchid2 
DarkOrchid3 
DarkOrchid4 
Purplel 
Purple2 
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125 
5 


38 
6 


PUrple3 
PUrpled 
MediumPurplej 
MediumPurple? 
MediumPurple3 
MediumPurple4 
thistlel 
thistle? 
thistle3 
thistle4 
gray0 
grey0 
grayl 
greyl 
gray2 
grey2 
gray3 
grey3 
gray4 
grey4 
gray5 
greys 
gray6 
grey6 
gray? 
grey7 
grays 
greys 
gray9 
grey 9 
gray10 
grey10 
grayli 
greyll 
gray12 
grey12 
gray13 
grey13 
grayl4 
greyl4 
gray15 
greyis5 
grayl6 
grey16 
gray17 
grey17 
grayl8 
grey18 
gray19 
grey19 
gray20 
grey20 
gray21 
grey21 
gray22 
grey22 
gray23 
grey23 
gray24 
grey24 
gray25 
grey25 
gray26 
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2.1.12 I font in Java 


2.1.12.1 La classe Font 


Per creare un'istanza della classe Font si usa il costruttore: 


Font (nome, stile, dimensione) 


dove: 


“nome è una stringa che caratterizza il modello di font, come ad esempio 
“TimesRoman”, “Helvetica”, “Courier”; 


~ stile rappresenta lo stile che può essere fissato con uno dei valori Font. PLAIN (per 
Caratteri normali), Font -BOLD (per caratteri in grassetto) o Font. ITALIC (per caratteri in 
corsivo), che sono delle costanti statiche intere definite nella classe Font stessa, potendo anche 
essere dato uno stile combinato Font.BOLD + Font. ITALIC per sommare le due 


Caratteristiche di grassetto e corsivo contemporaneamente; 


- dimensione è la dimensione del font che rappresenta, anche se non sempre, l'altezza dei 
caratteri. 


Per vedere un esempio con la stampa di Stringhe con vari font si può andare al paragrafo 8.1.8 e 
alla figura 6.11. 


Se non si trova sul sistema un font corrispondente a quello richiesto, Java adotta un font di 
default (di solito il Courier). Comunque Ia classe Toolkit del packege java.awt ha un 
metodo, getFontList(),che fornisce una lista dei font disponibili sul sistema usato. 


#vedi progr. In Grafica 2D! 


2.1.12.2 Caratteristiche di un font 


La classe Font dispone di vari metodi per ricavare le caratteristiche di un font: 











getName () restituisce il nome del font come stringa 


getStyle() restituisce lo stile del font (0 normale, 1 grassetto, 2 corsivo, 3 gras+cors) 


getSize() restituisce la dimensione del font 
isPlain() restituisce un booleano che dice se il font è normale 
isBold() restituisce un booleano che dice se il font è in grassetto 


isItalic() restituisce un booleano che dice se il font è in corsivo 











9] 
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Se si vuole conoscere il font utilizzato in un contesto grafico c'è il metodo getFont() della 
classe Graphics. 


2.1.12.3 Dimensioni dei caratteri dei font e delle stringhe in pixel 
(classe FontMetrics) 


Può essere utile a volte conoscere le caratteristiche dimensionali di un certo font usato, per 
esempio le dimensioni dei suoi caratteri per poter sistemare una scritta in un certo modo, ad 
esempio orizzontalmente e verticalmente al centro di una determinata area rettangolare. E’ con la 
classe FontMetrics del package java.awt che si possono ottenere informazioni su queste 
caratteristiche, come l'altezza e la larghezza dei caratteri di un determinato font. Le dimensioni 
sono espresse in pixel, 


Con getFontMetrics(Font) della classe Component o getFontMetrics() 
della classe Graphics si può istanziare un oggetto di tipo FontMetrics, che attraverso i 
suoi metodi fornisce le informazioni volute sulle dimensioni relative a quel font (si crea cioè un 
oggetto “misuratore” del font). I metodi di questa classe sono: 


getHeight () fornisce l'altezza del font (somma di ascent, descent e leading) 
charWidth (char) fornisce la larghezza di un determinato carattere 

stringWidth (String) fornisce la larghezza totale di una determinata stringa 

getAscent () fornisce la distanza tra la linea base dei caratteri e l'estremità superiore 


getDescent () fornisce la distanza tra la linea base dei caratteri e l'estremità inferiore 


getLeading() fornisce la distanza tra ascent di una riga e descent di un'altra 





Ecco un esempio di codice per sistemare una stringa verticalmente e orizzontalmente al centro 
di un rettangolo. 


(v pag.167)# 


g-getFontMetrics().getHeight(); // altezza in pixel dei caratteri 
g.getFontMetrics{().charWidth(c}); // larghezza in pixel del carattere c 


g.getFontMetrics().stringWiadth(s); //larghezza in pixel di una stringa 


Font disponibili su un sistema 


te nai 
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Per vedere quale sono i font disponibili su un sistema si può usare il metodo 
getFontList() di Toolkit.getDefaultToolkit {) (il Toolkit dell’ AWT è usato per 
legare le classi astratte AWT ad un particolare implementazione nativa del Toolkit, il suo metodo 
getDefaultToolkit() restituisce il Toolkit di default e getFontList(}) restituisce 1 
nomi dei font disponibili sotto forma di un array di stringhe), come è fatto nell esempio seguente: 


// I09listaFont.java (F.Spagna) Lista dei font disponibili 


import java.awt .Toolkit; 
public class I09listaFont { 


public static void main(String args[]) { 
String font[] = Toolkit.getDefaultToolkit().getFontList(}; 
System.out.println("Disponibili i " + font.length + " font seguenti:"); 
for (int n = 0; n < font.length; n++) 
System.out.println(" - " + font[n]); 
System.exit (0); 


Disponibili i 9 font seguenti: 
Dialog 
SansSerif 
Serif 
Monospaced 
Helvetica 
TimesRoman 
Courier 
DialogInput 
ZapfDingbats 





2.1.13 Grafica animata 


2.1.13.1 Necessità di un thread per l'animazione 


Immaginiamo di voler programmare un'animazione consistente in un rettangolino nero che si 
muove entro l’area di un'applet procedendo da sinistra a destra un pixel alla volta (ogni secondo). 
Se si fa un loop dentro il metodo init (), che è il primo dell’applet a partire, facendogli 
chiamare ciclicamente con un while il repaint() con il codice riportato qui di seguito, si 
ha la sorpresa di trovare che l’animazione non funziona e ciò è dovuto al fatto che il while 
monopolizza tutta l'attività del processore tanto da non permettere neanche il disegno da parte del 


paint (). 
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// Il0motoNo.java {F.Spagna) Animazione non funzionante senza un thread 


import java.awt.*; 
public class I10conta extends java.applet.Applet { 


int i; 
public void init() { 
while (true) { 
try { 
Thread.sleep(1000); 
} catch(InterruptedException e) {} 
repaint (); 
i++: 
} 
} 
public void paint (Graphics g) { 
g.fillRect(5*i % 100, 10, 5, 10); 
} 





La soluzione per ottenere l’animazione sta nel fare agire l'applet in un thread che permetta la 
coesistenza delle sue azioni con le altre operazioni del sistema. Ecco allora il codice che in questo 
modo fa funzionare correttamente l'applet: 


// ITllmoto. java F.Spagna Animazione funzionante con un thread 
import java.awt.*; 


public class Illconta extends java.applet.Applet implements Runnable { 
int i; 
Thread th; 
public void start() { 
if (th == null) { 
th = new Thread(this); // ai istanzia un thread per l'applicazione 
th.start(); 
} 
} 
public void stop() { 
if (th != null) { 


th.stop(); 
th = null: 


} 
} 
public void run() { 
while {true} { 
try { 
Thread.sleep(1000); 
} catch(InterruptedException e) {} 
repaint (); 
i++; 
} 
} 
public void paint (Graphics g) { 
g.fillRect(5*i % 100, 10, 5, 10); 
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} 
} 


Un'applet che lavori in un thread deve implementare l'interfaccia Runnable, deve avere una 
variabile d'istanza di tipo Thread che rappresenta (referenzia) il thread di esecuzione dell'applet, 
un metodo start ({) nel quale si fa partire il thread, uno stop() che lo ferma ed un metodo 
run} in cui si definisce tutta l'attività dell'applet. La classe Thread appartiene al package 
Java.lang, che non è necessario importare in quanto esso è importato automaticamente in ogni 
programma Java. L'interfaccia Runnable presenta il solo metodo run() che parte subito 
dopo il metodo start () dell’applet se in questo si fa partire un thread. Il metodo run() 
rappresenta tutto il funzionamento del thread in quanto contiene il codice delle operazioni che si 
vogliono fare svolgere in modo indipendente nel thread (per esempio un loop per un'animazione). I 
metodi che vengono chiamati all'interno di run() lavorano anch'essi nel thread. 


E' da tenere presente che, soprattutto nelle animazioni, non sempre un repaint() trova 
immediatamente il paint () conseguente disponibile, ma in certe condizioni, soprattutto se le 
risorse di sistema sono troppo sfruttate, il paint () richiesto da un repaint () può non 
essere eseguito subito e, se le richieste continuano, può formarsi una coda di richieste di 
paint () e in queste condizioni Java può anche decidere di eseguire solo l'ultima chiamata, 
saltando le precedenti in attesa. Un effetto di questo tipo si nota anche nell'esecuzione dell'applet 
precedente. 


2.1.13.2 Metodi paint (), update(), repaint() e animazioni 


Il metodo repaint() della classe Applet serve per ridisegnare l'area dell'applet, con il 
metodo paint (), che esso richiama, ma, diversamente da paint(), che viene mandato in 
esecuzione automaticamente dal browser quando ce n'è bisogno, esso deve essere richiamato 
esplicitamente nel programma (paint () forzato a programma). 


Prima di ridisegnare l'area dell'applet con un paint (), il metodo repaint() cancella 
ogni volta tutta quella preesistente (e ciò è dovuto al fatto che repaint () chiama update () 
il quale pulisce l'area del componente con il suo colore di fondo (cioè lo cancella) e quindi chiama 
il paint (), che disegna secondo quanto è definito in esso. Infatti se si va a vedere la definizione 
del metodo update() della classe Component: 


public void update(Graphics g} { 
g.setColor(getBackground(}}; 
g.fillRect(0, 0, width, height); 
g.setColor(getForeground()); 
paint(g); 


si vede come, prima di chiamare il metodo paint (), esso cancella l'area. 


Tutto ciò, nel caso di esecuzioni successive del metodo ripetute in un loop (per esempio se il 
repaint() è inun while per produrre una grafica animata mediante una successione di 
operazioni grafiche), produce un effetto di immagine intermittente (in inglese flickering o blinking). 


Le soluzioni per ridurre questo effetto possono essere: 
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- ridefinire il metodo update () lasciandogli il solo paint (), 
- ridurre al minimo necessario l'area che viene ridisegnata ogni volta, 
- preparare prima il disegno in memoria (double buffering). 


Vedremo in dettaglio nei tre paragrafi seguenti i tre accorgimenti. 


2.1.13.3 Ridefinizione di update () 


Per evitare la cancellazione dello schermo ad ogni invocazione del metodo paint () ogni 
volta che viene ridisegnata l'applet si può ricorrere alla ridefinizione del metodo update (} 
dell'applet: questo metodo, che come si è detto nel paragrafo precedente, è chiamato 
automaticamente ogni volta che l'area dell'applet viene ridisegnata con un repaint ( ), prima di 
chiamare i] paint () cancella l'area dell'applet: se allora si ridefinisce update() facendogli 
fare la sola operazione di richiamare il paint (): 


public void update(Graphics g) { 
paint (g); 
} 


la cancellazione dell'area insita nella versione della superclasse del metodo non ha luogo e questo 
riduce l’effetto di flickering. 


2.1.13.4 Riduzione dell'area ridisegnata 


Oltre che con il sistema del paragrafo precedente, dal punto di vista della fluidità 
dell'animazione le cose possono essere migliorate anche riducendo l'area ridisegnata ogni volta 
(cioè quella soggetta a flicker) alle dimensioni strettamente necessarie con il metodo 
clipRect (xl, y1, larghezza, altezza). 


Ritornando alla ridefinizione di update() ricordata al paragrafo precedente, le cose 
migliorerebbero scrivendo: 
public void update(Graphics g) { 


g.clipRect(x1, yl, larghezza, altezza); 
paint (g); 


2.1.13.5 Tecnica del double buffering delle immagini 


Ma con gli accorgimenti precedenti i problemi del flickering sono solo in parte risolti: per 
migliorare decisamente la qualità dell'animazione si può ancor meglio ricorrere alla tecnica del 
double buffering. 


Il double buffering (in italiano potrebbe essere chiamato “doppio tampone”, ma è il termine 
inglese che viene comunemente usato) è una tecnica che può essere adoperata con vantaggio 
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quando si deve disegnare una sequenza di immagini sull'area di un'applet e più in generale di un 
Panel o di un Frane, e che consiste nel preparare di volta in volta il disegno, compreso 
l'inserimento di eventuali immagini, non sull'area stessa da disegnare, ma fuori schermo in un 
oggetto (contesto grafico) di tipo Graphics creato in memoria (buffer) (operazione che Java 
permette di fare agevolmente) e poi riprodurlo tutto insieme in un solo colpo e quindi velocemente 
copiando l'area della memoria sull'area da disegnare (per esempio quella di un'applet) e 
sovrapponendola a quella preesistente. Tale tecnica permette di ottenere una successione di 
immagini più continua e fluida, senza il tremolio tipico prodotto da un disegno diretto delle 
immagini sullo schermo. 


Il disegno viene preparato su un oggetto di tipo Image, creato con il metodo 
createImage() della superclasse Component che crea un'immagine disegnabile fuori 
schermo e a questo oggetto è associato un contesto grafico di tipo Graphics, che è creato 
mediante il metodo getGraphics () dell'oggetto di tipo Image che serve per disegnare 
sull’ immagine stessa fuori schermo. 


Ogni volta che, richiamato dal metodo repaint () inserito in un loop (che è posto il più 
delle volte nel metodo run () dell'applet implementata come Runnable), viene eseguito il 
paint (), esso può disegnare subito con un drawImage() l'immagine che era stata già 
preparata in memoria (operazione che in tal caso è molto veloce) e l'applicazione diventa 
disponibile per riprendere di nuovo le operazioni di disegno in memoria preparandosi alla prossima 
invocazione del metodo paint (), mentre l'immagine sullo schermo non viene toccata e rimane 
stabile. Notiamo che l'ultimo argomento di drawImage() prevede il parametro che specifica il 
richiedente del ...# e nel nostro caso questo è rappresentato dall'applet stessa, e quindi al metodo 
viene passato il this, che è la referenza dell'oggetto (l'applet) su cui è presentata la sequenza di 
immagini. 

Questa tecnica è la più efficace perchè elimina radicalmente il flickering, però ha lo svantaggio 
di essere meno efficiente delle altre in termini di prestazioni ed esigente in fatto di memoria e 
perciò è meglio non usarla quando può essere evitata. 


Quando si programma il metodo paint (), per ragioni di efficienza, soprattutto nel caso di 
animazioni, si deve evitare per quanto possibile di caricarlo con delle operazioni che potrebbero 
essere fatte altrove, in quanto quando il metodo è chiamato è bene faccia tempestivamente le cose 
che è chiamato a fare, e cioè il disegno. 


Segue un programma di esempio con un'animazione costituita da una scritta che scorre sullo 
schermo insieme ad un'immagine (un piccolo aereo). 


// I12A40ubuf045. java {F.Spagna) Scritta scorrevole con il double buffering 


import java.awt.*; 


public class I12doubuf045 extends java.applet.Applet 
implements Runnable { 
Image aereo; 
Image imgMemo; 
Graphics gr; 
Thread th; 
String scrit; 
int bas, alt; 
Color colScrit, colFondo; 
int i; 
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public void init() { 
scrit = getParameter("scritta"); 
bas = integer .parseInt (get Parameter ("base") ); 
alt = Integer.parseInt(getParameter("altezza")); 
colScrit = new Color (Integer .parseInt (getParameter("colorscr"), 16)}; 
colFondo = new Color(Integer.parseInt (getParameter("colorfond"), 16)); 
aereo = getImage(getCodeBase(), "aereo.,gif")}; 
imgMemo = createImage (bas, alt); 
gr = imgMemo.getGraphics(); 





















} 
public void start() { 
if (th == null) { 
th = new Thread(this); 
th.start(); 







} 






} 
public void stop() { 
if (th I= null) { 
th.stop(); 















th = null; 
} 
} 
public void run() { 
while (true) { try { 
Thread.sleep(100); } catch (InterruptedException e){} 
preparaImgMemo(); 
repaint (); 
i++; 
} 
} 






void preparaImgMemo() { 
gr.setColor{colFondo); 
gr.fillRect(0, 0, bas, alt); 
gr.setColor(colScrit); 
gr.setFont (new Font ("TimesRoman", Font.BOLD, 28)); 
gr.drawString(scrit, i % bas, alt - 20); 
gr.drawString(scrit, i % bas - bas, alt - 20); 
gr.drawImage(aereo, i % bas - 50, 5, 40, 28, this); 









} 
public void update(Graphics g) { 
paint (g); 






} 
public void paint(Graphics g) { 
g.drawImage(imgMemo, 0, 0, this); 






} 





Si noti in particolare nel codice: 


- la definizione delle due variabili d'istanza di tipo Image e Graphics rispettivamente per 
l'immagine da preparare in memoria e per il contesto grafico associato ad essa, variabili istanziate 
nel metodo init (); 


- la creazione di un metodo speciale (cui abbiamo dato il nome preparaImgMemo ()) per 
preparare l'immagine fuori schermo in memoria che è chiamato ad ogni ciclo dal while entro il 
metodo run() e che raccoglie tutte le operazioni grafiche fatte in memoria: 
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- la semplicità assoluta del metodo paint () cui viene affidata la sola funzione di riprodurre 
in un colpo solo sullo schermo l'immagine precedentemente preparata in memoria: infatti è bene 
sempre per ragioni di efficienza evitare di fare in questo metodo operazioni che possono invece 
essere fatte fuori, soprattutto per le animazioni in quanto, quando il metodo è chiamato, deve essere 
pronto per disegnare subito; 


- la solita ridefinizione del metodo update () per eliminare la cancellazione dello schermo 
ad ogni repaint (). 


Al programma dimostrativo, di per sé molto semplice, abbiamo aggiunto alcune altre cose: 


- per generalizzare l'applet e renderla flessibile nell’uso abbiamo aggiunto la possibilità di 
inserire alcuni dati come parametri passati ad essa dall'HTML, come il contenuto della stringa, la 
base e l'altezza entro cui scorre la scritta, il colore della scritta ed il colore di fondo; 


- il contenuto della scritta viene passato come stringa e come tale utilizzato all’interno 
dell’applet e quindi non richiede alcun trattamento; 


- 1 parametri base e altezza sono passati come stringhe, ma sono tradotti nel programma in interi 
con la funzione Integer.parseInt (String); 


- i due parametri dei colori sono passati come stringhe che esprimono il colore in valore 
esadecimale e devono essere poi tradotti in termini di colore nel programma prima calcolandone il 
valore intero con il metodo Integer.parseInt (String, 16) questa volta con una radice 
16 (relativa ai numeri esadecimali) e poi il colore viene creato con un construttore avente un 
argomento così rappresentato; 


- per riprendere da sinistra la scritta scorrevole via via che essa scompare sulla destra, se ne 
scrive sempre una seconda sfalsata all'indietro di un numero di pixel uguali a quello della 
lunghezza della base dell’area dell’applet, e questo funziona bene anche quando l'ascissa di inizio 
della stringa è negativo, cioè fuori dell'area dell'applet. 


Si riproduce in figura 9.23 la figura ripresa al volo in certo istante per un'applet lanciata da un 
HTML così scritto: 


<html> 

<applet code=doubuf045.class width=400 height=40> 
<param name=scritta value="questo è un aereo che vola"> 
<param name=base value="400"> 


<param namezaltezza value="50"> 

<param name=colorscr value="0000££"> 

<param name=colorfond value="ffff00%> 
</applet> 





n aereo che vola A questo è u 


Figura 9.23 Animazione con una scritta scorrevole. 
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2.1.13.6 Animazioni con immagini 


Un'animazione con delle immagini può essere fatta in un'applet che lavora in un thread 
presentando in successione una serie di immagini una di seguito all'altra come in un film in una 
posizione fissa sullo schermo, e in tal caso l'effetto di movimento è prodotto soltanto dal contenuto 
delle immagini, o anche, se si vuole, con uno spostamento della posizione dell'immagine, con 
intervalli di tempo abbastanza piccoli da produrre la sensazione dell'animazione. 


La serie di immagini, che di solito vengono poste tutte in una sottodirectory di quella dove è 
situata l'applet e cioè il suo bytecode, sono in genere rappresentate nel programma da un array (0 
ancor meglio un Hashtable) di oggetti di tipo Image. Se per esempio supponiamo che le 
immagini sono in numero di 10 e i file relativi sj chiamano img0.gif, img] gif, ... img9.gif e sono 
poste in una sottodirectory immagini/ di quella dell'applet, si scriverebbe: 


Image img[] new Image[10] // variabile d'istanza della classe 
for (int n= 0; n< img.length; n++) // nel metodo init() 
img[n] = getImage (getCodeBase(), “immagini/img” + n + “. gif”); 


(si noti il modo adoperato per chiamare file con nomi diversi con un unico loop). 


Un esempio interessante di animazione in Java è rappresentato dall'applet Animator che si trova 
negli esempi del JDK. 


2.1.13.7 Caricamento delle immagini e classe MediaTracker 


La classe MediaTracker permette di creare degli oggetti che sono capaci di sorvegliare 
(track) lo stato di vari oggetti multimediali, anche se per il momento sono supportate soltanto le 
immagini. Per far questo si crea un'istanza della classe e si aggiungono ad essa le immagini di cui si 
vuol seguire lo stato con il metodo addImage (). A ciascuna immagine si può assegnare un 
numero di identificazione che ne indicherà la posizione in sequenza, potendo una serie di immagini 
avere lo stesso numero e quindi essere trattata nel suo insieme. 


Variabili di classe pubbliche: 


ABORTED Flag indicante che il caricamento non è riuscito 


COMPLETE Flag indicante che il caricamento è stato completato con successo 


ERRORED Flag indicante che il caricamento ha incontrato un errore 


LOADING Flag indicante che il caricamento è in corso 





Costruttore: 


MediaTracker (Component ) 
Creates a Media tracker to track images for a given Component. 
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Metodi: 









addImage(Image, int) 
aggiunge un'immagine alla lista di immagini da sorvegliare 





addImage(Image, int, int, int) 
aggiunge un’ immagine ridimensionata alla lista di immagini da sorvegliare 
checkAll()} 
vede se tutte le immagini hanno finito di essere caricate, ma non inizia il 
caricamento se questo non è già in atto 
checkA11 (boolean) 
vede se tutte le immagini hanno finito di essere caricate 










checkID(int) 
vede se tutte le immagini marcate con un dato ID hanno finito di essere caricate, 
ma non inizia il caricamento se questo non è già in atto 







checkID(int, boolean) 
vede se tutte le immagini marcate con un dato ID hanno finito di essere caricate 







getErrorsAny() 
restituisce una lista di tutti i media che hanno incontrato un errore 






getErrorsID(int) 
restituisce una lista di media con un dato ID che hanno incountrato un errore 






isErrorAny() 
vede lo stato di errore di tutte le immagini 







isErrorID(int) 
vede lo stato di errore di tutte le immagini con un dato ID 







removelImage (Image) 
rimuove dal MediaTracker l’Image specificata 







removeImage (Image, int) 
rimuove dal MediaTracker l’ Image specificata con un dato ID 





removeImage (Image, int, int, int) 
rimuove dal MediaTracker l’Image specificata con una data dimensione e ID 






statusAll (boolean) 
restituisce il booleano OR dello stato di tutti i media da sorvegliare 





statusID(int, boolean) 
restituisce il booleano OR dello stato di tutti i media con un dato ID 






waitForAll() 
inizia il caricameto di tutte le immagini 






waitForAll(long) 
inizia inizia il caricameto di tutte le immagini 







waitForID(int) 
inizia il caricameto di tutte le immagini con un dato ID e aspetta finchè hanno inito di 
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essere caricate o ricevono un errore 





waitForID(int, long) 
inizia il caricameto di tutte le immagini con un dato ID 














java (F. Spagna) Animazione con immagini 
// 01-16.11.98 (inizio 14 novembre 19998) 


import java.awt.*; 






public class I113anim058 extends java.applet.Applet implements Runnable { 







final int NIMG = 18; // numero di immagini usate nell'animazione 
Image img[] = new Image[NIMG]; // array delle immagini istanziato 
Image sfondo; // immagine di sfondo 











int im; // indice dell'immagine corrente da disegnare 
boolean caricate; // indica se tutte le immagini sono State caricate 
MediaTracker tracker; // tracker 
Thread th; // oggetto Thread dell'applet 








public voia init() ¢ 

tracker = new MediaTracker (this); // istanzia il tracker 

sfondo = get Image (getDocumentBase(), "images/background.gif"), 

tracker. addImage (sfondo, 0); // aggiunge immagine di fondo con id = 0 

for (int i = 1; i <= NIMG; i++) { // ogni immagine dell'animazione 
img[i-i] = getImage (getDocumentBase(), // viene stabilita 

"images/img00" + ((1<10) ? wọ» 3") + i+ ".gif"); 

tracker.addImage(img[i-1], 1); // e aggiunta al tracker con id = 1 











} 





} 
public void paint (Graphics g) { 
g-drawString("Caricamento immagini...", 10, 20); //messaggio d'attesa 
if ( (tracker.statusAll(false) & MediaTracker.ERRORED) t= 0) { 
g.setColor (Color. red); //se errori caricamento immagini rettang.rogso 
g.fillRect(0, 0, size().width, size().height); 
return; 













} 
g.drawImage (sfondo, 0, 30, this);//sempre disegna sfondo incrementalmente 
if (tracker.statusIn(1, false) == MediaTracker.COMPLETE) 

g.drawImage (imglim], 100, 100, this);//disegna solo se caricate tutte 









public void run() { 
try { // prima di cominciare l'animazione 
tracker.waitForID(0); //aspetta che immagine di fondo sia tutta caricata 
tracker.waitForID(1);//aspetta che immagini di animazione siano caricate 












// tracker.waitForAll(); // aspetta finche'tutte le immagini Caricate 
} catch (InterruptedException e) { return; } 

im = 0; // comincia con la prima immagine 

while (true) { // cicla indefinitamente 

repaint(); // disegna l'immagine corrente 










try { Thread.sleep(150); } catch(InterruptedException e) { break; } 
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im++; // incrementa l'indice dell'immagine 









im %= NIMG; 
} 
} 
public void update (Graphics g) { // per eliminare il tremolio 
paint (g); 
public void start() { // fa partire il thread dell'animazione 
th = new Thread(this); 
th.start(); 
} 
public voia stop() { // ferma il thread dell'animazione 





th.stop(); 
th = null; 












try { 
tracker .waitForAll(); // aspetta finche'tutte le immagini caricate 
caricate = ‘tracker.isErrorAny(); // il tracker informa se caricate 
} catch (InterruptedException e) { } 
f* 
“a Be oa hes hehe ae 


Class fram extends Frame { 


public fram(String str) { 
Super (str); 


Public boolean handleEvent (Event evt) { 
switch (evt.id) { 
case Event. WINDOW_DESTROY: 
dispose(); 
System.exit (0), 
return true; 
default: 
return super. handleEvent (evt) ; 


The init) method is called by the AWT when an applet is first loaded or reloaded. Override 
this method to perform whatever initialization your applet needs, such as initializing data 


structures, loading images or fonts, creating frame windows, setting the layout manager, or adding 
UI components, 


destroy() Place additional applet clean up code here. destroy() is called when your applet is 
terminating and being unloaded. 


The run() method is called when the applet's thread is started. If your applet performs any 
ongoing activities without waiting for user input, the code for implementing that behavior typically 








goes here. For example, for an applet that performs animation, the run() method controls the 
display of images. 


meaning that another thread has interrupted this one 


This frame class acts as a top-level window in which the applet appears when it's run as a 
standalone application. 


The handleEvent() method receives all events generated within the frame window. You can use 
this method to respond to window events. To respond to events generated by menus, buttons, etc. 
Or other controls in the frame window but not managed by the applet, override the window's 
action() method. 


For each image in the animation, this method first constructs a string containing the path to the 
image file; then it begins loading the image into the img array. Note that the call to getImage will 
return before the image is completely loaded. 


If re-entering the page, then the images have already been loaded. caricate == TRUE. 


Rectangle r = g.getClipRect(); 
g.clearRect(r.x, r.y, r.width, r.height); 


update paint() The background image fills our frame so we don't need to clear the applet on 
repaints, just call the paint method. 


run() Run the animation thread. 


if ((tracker.statusAll{false) & MediaTracker.ERRORED) != 0) { 
// Paint a large red rectangle if there are any errors loading the images 
g.setColor(Color.red); 
g.fillRect(0, 0, size() .width, size().height); 
return; 
} 
g.drawImage (sfondo, 0, 0, this); 


Otherwise always paint the background so that it appears incrementally as it is loading. 
if (tracker.statusID(1, false) == MediaTracker.COMPLETE) 


Finally, only paint the current animation frame if all of the frames (id == 1) are done loading so 
that we don't get partial animations. 


/* 
if (standAlone) 
img{i-1l] = Toolkit .getDefaultToolkit (}.getImage(strImg) ; 
else 
img{i-1] = getImage (getDocumentBase(), striImg) ; 
* 
/ 
/* 
boolean standAlone = false; // posto true se standalone 
public static void main(String args[]) { 


fram fr = new fram("Animazione"); 
fr.show(); // necessario perche' insets() restituisca valori validi 
fr.hide{(); 
fr.resize(fr.insets().left + fr.insets{).right + 320, 
fr.insets().top + fr.insets().bottom + 240); 
anim060 a60 = new anim060(); 
fr.add("Center", a60); 
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a60.standAlone = true; 
a60.init(); 
a60.start(); 
fr.show(); 


nie 
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2.2 Grafica a 2 dimensioni 


2.2.1 L’API 2D di Java 


Nella versione 1.2 del JDK sono state introdotte funzionalità di grafica a due dimensioni con 
l'API Java 2D facente parte del core stesso dell'AWT che permettono una grafica avanzata con il 
disegno di forme geometriche complesse e la trasformazione del sistema di coordinate, e mettono a 
disposizione mezzi più sofisticati di quelli precedenti per il disegno di testi e font, il trattamento 


delle immagini, la gestione dei colori e la stampa indipendente dal dispositivo (device- 
independent). 


Mentre nel JDK 1.1 si potevano disegnare solo alcune forme Semplici (rettangoli, ellissi, 
poligoni) con una linea di Spessore fissato, con questa nuova libreria si può disegnare qualunque 
tipo di forma con diversi stili di linea e di riempimento. Gli oggetti grafici disegnati possono poi 
essere trasformati con una traslazione, rotazione, cambiamento di scala o scorrimento (shear). I 


colori possono essere sovrapposti con un effetto di trasparenza. 


[8.1] Bill Loeb, The Java 2D API, Dr.Dobb’s Journal, #296, February 1999, page 44. 


2.2.2 Classe Graphics2D 


Alla base di tutta la grafica bidimesionale sta la classe astratta Graphics2D del package 
java.awt che estende la classe Graphics dello stesso package. Generalmente nel metodo 
paint() del'applet o dell'applicazione viene creato un oggetto di classe Graphics2D 


ottenuto facendo il casting dell'oggetto di tipo Graphics che è passato come argomento dal 
sistema al metodo: 


Graphics2D g2D = (Graphics2D)g; 


Una differenza importante con la grafica dell'AWT 1.0 è la possibilità di specificare le 
coordinate dei punti nel piano con numeri in virgola mobile anzichè interi. 


Metodi: 






abstract void draw(Shape s) 
disegna una forma 







public abstract void fill{Shape s) 
disegna una forma piena 


public abstract void drawImage (diverse Signature) 
disegna un'immagine 





abstract void drawRenderedImage (diverse signature) 
disegna un'immagine applicando la trasformazione corrente 
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abstract void hit 


(argomenti) 
va a vedere se 








nfiguration 
restituisce la device configuration 


public abstract void setc 
va a vedere se 


FetDeviceconfiguration() 


omposite (argomenti) 
Public abstract void SetPaint (argomenti) 
Va a vedere se 
public abstract void setst 


roke (argomenti) 
va a vedere se 


va a vedere se 






Public abstract int getRen 


deringHints (argomenti) 
restituisce 


public abstract void trans 


late (vari argomenti) 
Vv 





Public abstract 
y 





void rotate (vari Argomenti) 


public abstract 


void scale(argomenti) 
y 


Public abstract void shear (argomenti) 


void hit (argomenti) 





abstract void (Fansform(AffineTransform) 
trasforma gli assi dell'utilizzatore 


abstract void set 
t 


Public 






Transform(AffineTransform) 






public 





abstract AffineTran 
restituisce 






public abstract Paint 


getPaint() 
restituisce 






public abstract Composite 


restituisce 






public abstract void set 


Background (Color) 
t 





public 





abstract Color gets 
restituisce 
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public abstract Stroke getStroke() 
restituisce 










public abstract void clip(Shape s) 
interseca il clip corrente con l'interno di una data forma 





2.2.3 Linea passante per più punti 


La classe GeneralPath, contenuta nel package java.awt.geom, rappresenta una linea 
che passa per più punti, come la polygon dell'AWT 1.0, ma con la possibilità di unire i punti 
non solo con segmenti di retta, ma anche con curve quadratiche o cubiche di tipo curve di Bezier, 
permettendo quindi la creazione di forme complesse. Un GeneralPath può contenere diversi 
subpaths. 


La regola di avvolgimento (winding rule) specifica come viene determinato l'interno della figura 
delimitata dalla linea: la regola EVEN_ODD e quella NON_ZERO (per la spiegazione di questa 
Caratteristica si rimanda a quella data nel JDK 1.2 stesso). 


Questa classe implementa l'interfaccia Shape. 


Metodi: 






GeneralPath{) 
diversi costruttori, tra cui uno che riceve un parametro che specifica la regola di 
winding ehe può essere stabilito mediante il valore della costante di classe 
General Path. EVEN_ODD oppure GeneralPath.NON_ZERO 

moveTo(float x, float y) 
aggiunge un punto alla linea spostandosi sulle sue coordinate senza tracciare alcuna linea 

lineTo (float x, float y) 
aggiunge un punto alla linea tracciando un segmento di retta tra l'ultimo punto 
ed uno successivo (x, y) 

quadTo(float x1, float yl, float x, float y) 

aggiunge due punti alla linea tracciando una curva quadratica tra l'ultimo 

punto ed uno successivo (x, y) con un punto intermedio di controllo (x1, y1) 


curveTo(float x1,float yl, float x2,float y2, float x, float y) 
aggiunge tre punti alla linea tracciando una curva di Bezier cubica tra l'ultimo punto 
ed uno successivo (x, y) con due punti intermedi di controllo (x1, y1) e (x2, y2) 

closePath() 


chiude la linea ritornando al punto imiziale con una linea retta 
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append(Shape s, boolean connect) 
aggiunge alla linea un oggetto di tipo Shape 


append(PathIterator pi, boolean connect) 
aggiunge alla linea un oggetto di tpo PathIterator 


transform(AffineTransform) 
trasforma la geometria della linea secondo una trasformazione data 


boolean contains(diversi possibili argomenti specificanti un punto) 
va a vedere se un punto è contenuto nella figura racchiusa dalla linea 


Rectangle getBounds() 
restituisce il rettangolo delimitante la linea 





Esempio:# 


2.2.4 Traslazione e rotazione degli assi 


La classe AffineTransform, contenuta nel package java.awt.geom, rappresenta una 
trasformazione affine con conservazione delle linee rette e del parallelismo tra rette che permette di 
effettuare la traslazione. la rotazione, il cambiamento di scala e lo shear degli assi di riferimento e 
quindi di una figura. variando il cosiddetto spazio dell'utilizzatore (user space) rispetto allo spazio 
del dispositivo (device space). 


Metodi: 


setToTranslation(float, float) 
effettua la traslazione di un certo valore per x ed un altro valore per y 


setToRotation(float) 
effettua la rotazione di un certo numero di radianti 





2.2.5 Font e testo 2D 


Con l'API Java "D le stringhe possono essere disegnate con tradformazione affine come 
qualunque altra forma disegnata. E' anche possibile ottenere un oggetto di tipo Shape che 
rappresenti la stringa come disegno con il quale possono essere fatte tutte le operazioni possibili 
con qulasiasi altro elemento grafico. 


Il testo dopo una rotazione risulta dentellato. 


[8.2] Bill Day, Java Media, Getting started with Java 2D, Java World, July 1998. 
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2.3 Trattamento avanzato delle immagini 


2.3.1 Creazione di un’immagine JPEG 


essere particolarmente utile ad esempio nel caso di un serverlet che debba trasmettere al cliente con 
una pagina HTML un'immagine creata al volo in relazione alle circostanze della richiesta. 


Per far questo si crea l'immagine come oggetto della classe Buf feredImage, si disegna 
quello che si vuole sul suo contesto grafico (oggetto di tipo Graphics) e si codifica su un 
Buffered0Output Stream l’immagine sottoposta al’encoder rappresentato da un’istanza di 
JPEGImageEncoder. L'esempio seguente mostra tutto Ciò: 


L'immagine così creata e salvata in un file immag. jpg è mostrata nella figura 9.24 seguente. 


Figura 9.24 Immagine JPEG creata con encoder java. 


111 





Java.awt 


class BorderLayout 


Button 
Canvas 
CardLayout 
Checkbox 
CheckboxGroup 
CheckboxMenuItem 
Choice 

Color 

Dialog 
Dimension 
Event 
FileDialog 
FlowLayout 
Font 
FontMetrics 
Frame 
Graphics 
GridLayout 
GridBagLayout 
Image 

Insets 

Label 

List 

Menu 

Menubar 


MenuItem 


2.4 Tavola riassuntiva del package java.awt 


(Abstract Window Toolkit) 


contiene le classi per la gestione di interfacce grafiche utente 
layout riferito ai bordi 

bottone 

area di disegno 

layout a strati sovrapposti 
controllo di scelta si/no 

gruppo di Checkbox 

voce di un menù tipo Checkbox 
menù a tendina 

colore 

finestra di dialogo 

larghezza e altezza di un'area rettangolare 
evento nell'interfaccia grafica 

finestra di directory e file 

layout su righe orizzontali 

tipo di carattere delle scritte 

metrica di un tipo di carattere 

finestra con titolo 

contesto grafico (contiene tutti i metodi grafici) 
layout secondo una griglia 

layout secondo una griglia evoluto 
immagine 

distanze dai bordi 

etichetta con un testo 

lista scorrevole 

menù 

barra dei menù 


voce di menù 
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Panel 
Point 
Polygon 
Rectangle 
Scrollbar 
TextArea 
TextField 


Window 


pannello 

punto 

poligono 

rettangolo 

barra di scorrimento 

testo editabile su più righe 
testo editabile su una riga 


finestra base 


LIE SAE A is pa: E; Ste a oe VSS Farner anan TRETIRA Pi cai : S a uma TIZIO, = = TI Ere 
Se ia TT RE ES aE EEE A EARE T AE OCENE ee ` k Pa 
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3. Java Foundation Classes 


3.1 Le Java Foundation Classes (JFC) 


Le Java Foundation Classes (JFC) sono 


3.2 La libreria Swing 


3.2.1 Le classi Swing 


Le classi Swing 


Java.lang.Object. 


Classe base di ogni altra classe in Java 


\ 


/ 
EA 


superclasse astratta degli oggetti \ 
/ componenti uno scene graph \ 


\ 


/ 


classe astratta per oggetti / | classe astratta \ \ 
per uno scene graph / | \ 


f \ / | \ 
[swing.ccomponent] [] ANO 


oggetti singoli / gruppo \ 


gruppo che può gruppo che contiene 
attaccarsi a un ramo una trasformazione 





Figura 10.1 Schema di discendenza ereditaria delle classi Swing. 


3.2.2 Classe JFrame 


La classe JFrame rappresenta 


E° qui riportato il codice di un semplice esempio di creazione di un frame tipo JFrame: 
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// JOlframe.java (F.Spagna) Semplice esempio di JFrame 







import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 







class J01frame extends JFrame { 
Container cp; 
public frame(String titolo) { 
super(titolo); 
cp = this.getContentPane(); 
cp.setBackground(Color.white); 
cp.setForeground(Color.blue); 
JLabel lab = new JLabel("Questo è un frame tipo Swing", JLabel.CENTER); 
lab.setFont (new Font ("Sans", Font.BOLD, 20)); 
cp.add{lab); 
addWindowListener (new WindowEventHandler()); 
setDefaultCloseOperation(WindowConstants.DISPOSE_ON_CLOSE) ; 
setSize(350, 200); 
show(); 














} 
public static void main(String[] args) { 
new frame("Frame Swing"); 






} 
class WindowEventHandler extends WindowAdapter { 
public void windowClosing(WindowEvent evt} { 
System.exit(0); 







} 






ll frame così creato può essere visto nella figura 10.2. 


Frame Swing 


zi 









Questo è un frame tipo Swing 





Figura 10.2 Esempio di finestra tipo JFrame. 
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3.2.3 Classe TLabel 


La classe JLabel rappresenta 


Un esempio di JLabel, che ripete quanto è già stato fatto con oggetti di tipo 
Label nell'esempio del paragrafo 7.2.2 (si trattava di disegnare una tavola 
pitagorica, vedi figura 7.3), è fatto qui di seguito: 


// J02label.java (F.Spagna) Esempio elementare di JLabel 


import java.awt.*; 
import javax.swing.*; 


public class 702label extends JApplet { 


public void init() { 
Container cp = getContentPane(}; 
cp.setLayout (new GridLayout (10, 10, 5, 5}}; // 10 righe 10 colonne gap=5 
cp.setBackground(Color.green); 
for (int r = 1; r <= 10; r++) 
for (int c = 1; c <= 10; c++) { 
JLabel lab = new JLabel("" + r*c, JLabel.CENTER); 
Lab. setHorizontalTextPosition(JLabel.LEFT) ; 
lab. setVerticalTextPosition(JLabel .TOP) ; 
lab. setBackground(Color.white); 
lab. setForeground(Color.black) ; 
lab. setOpaque (true); 
cp.add(lab); 





«Applet started. 
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Figura 10.3 Esempio di JLabel. 


3.2.3.1 Bordi dei JLabel 


Le etichette di tipo JLabel possono essere dotate di bordi di vario aspetto. 
Nell'esempio seguente vengono provati un po’ tutti i vari tipi disponibili: 


// J03bordìi.java (F.Spagna) Esempio di vari bordi sui JLabel | 


import javax.swing.border.*; 
import javax.swing.*; 
import java.awt.*; 


public class J03bordi extends JApplet{ 


static String titolo[] = { "Empty", "Etched", "Etched&Colored", 
"BevelSu", "BevelGiù", "BevelColor", "SoftBevel", "Matte", 
"Line", "Line", "Compound", "Titled" }; 


public void init()} { 


Icon icon = new ImageIcon("sun.gif"); 
Border bordo[] = new Border[12]; 
bordo [0] new EmptyBorder(1, 1, 1, 1); // insets 
bordo[1] new EtchedBorder(EtchedBorder.RAISED); 
bordo[2] new EtchedBorder(EtchedBorder.LOWERED, Color.red,Color.blue); 
bordo[3] new BevelBorder (BevelBorder.RAISED) ; 
bordo [4] new BevelBorder (BevelBorder .LOWERED)} ; 
bordo [5] new BevelBorder (BevelBorder.RAISED, Color.gray,Color.yellow) ; 
bordo[6] new SoftBevelBorder (BevelBorder.LOWERED) ; 
bordo[7] new MatteBorder(20, 20, 20, 10, icon); 
bordo[8] new LineBorder(Color.red, 5); // spessore linea 
bordo [9] LineBorder.createGrayLineBorder {)}; 
bordo[10] = new CompoundBorder (new BevelBorder (BevelBorder.RAISED), 
new EtchedBorder (EtchedBorder.RAISED) ); 

bordo[11] = new TitledBorder(new LineBorder(Color.red), 

"titolo", TitledBorder.DEFAULT_JUSTIFICATION, 

TitledBorder.CENTER, new Font("Sans", Font.BOLD, 16), Color.blue); 


JPanel pan = new JPanel(new GridLayout (3, 4, 5, 5)); 
for (int n = 0; n < 12; n++) { 
JLabel lab = new JLabel(titolo[n], JLabel.CENTER); 
lab. satOpaque (true); 
lab. setBorder (bordo[n] ); // assegna i bordi ai label 
pan.add(lab) ; 


} 
getContentPane().add(pan); 





In figura 10.4 si possono vedere su una griglia i vari tipi di bordi applicati alle 
diverse etichette del programma. 
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Applet started. 





Figura 10.4 Vari tipi di bordi applicati ad etichette JLabel. 


3.2.4 Classe JTextField 


La classe JTextField rappresenta 


Si fa qui un esempio di JTextField con un oggetto di questa classe che 
riceve i dati di input dell'utente ed un altro che mostra questi dati quando nel 
primo campo è battuto il tasto di invio. 


// JO4textfield.java (F.Spagna) Esempio di TITextField 


import 
import 
import 


public 


javax.swing.*; 
java.awt.*; 
java.awt.event .*; 


class J04textfield extends JApplet { 


Container cp; 
JTextField tf1, t£2; 
JLabel labi, lab2; 
public void init() { 


labl1 = new JLabel("entra dati: ", JLabel.RIGHT); 
labl.setFont {new Font ("", Font.BOLD, 18)}); 

lab2 = new JLabel("mostra dati: ", JLabel.RIGHT); 
lab2.setFont (new Font("", Font.BOLD, 18)); 

cp = this.getContentPane(); 

cp.setLayout (new GridLayout(2, 2, 0, 60)); 

t£1 = new JTextField("", 20); 
t£1.setBorder(BorderFactory.createLineBorder{(Color.black, 3)}); 
tfl.addActionListener(new TextFieldListener()); 

tf2 = new JTextField(20)}; 
t£2.setBorder{BorderFactory.createLineBorder(Color.blue, 3))3 
cp.add(labl); 
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cp.add(tfl); 
cp.add(lab2); 
cp.add(tf2); 


} 
class TextFieldListener implements ActionListener { 
public void actionPerformed (ActionEvent e) { 


t£2.setText (e.getactionCommand() ); 
} 


In figura 10.5 si vede l'applet dopo l'inserimento di un testo da parte 
dell'utente, 


fe Applet View 
“Applet betes 










: mostra dati: ; 


dati entrati 








Applet stared. 


Figura 10.5 Esempio di due JTextField collegati. 


3.2.5 Classe JRadioButton 


La classe JRadioButton rappresenta 


E' fatto qui di seguito un esempio di una serie di JRadioButton riuniti in un 
JRadioButton èpresenti su un'applet: 





// JOSradiob. java (F. Spagna) Esempio di JRadioButton riuniti in un ButtonGroup 





import java.awt.*; 
import javax. swing.*; 
import java.awt.event.*; 


public class J05radicb extends JApplet { 
JRadioButton rBot{] = new JRadioButton[3]; 
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JLabel lab; 
Container cp; 


public void init() { 
cp = getContentPane(); 
cp.setLayout (new GridLayout (2, 1))}; 
ascolt asc = naw ascolt(); 
ButtonGroup grup = new ButtonGroup(); 
JPanel pan = new JPanel(); 
pan, setLayout (new GridLayout (5, 1)); 
pan.add(new JLabel("Fai una scelta")); 
for (int n= 0: n < 3; n++) { 
rBot [n] = new JRadioButton("Scelta " + n, true); 
rBot [n] .addactionListener(asc); 
grup.add(rBot [n]); 
pan.add(rBot[n] ); 
} I 
lab = new JLabel("Scelta 0", JLabel.CENTER); 
lab. setFont (new Font ("Sans", Font.BOLD, 20)); 
pan.add(lab); 
cp.add (pan) ; 
} 
class ascolt implements ActionListener { 
public void actionPerformed(ActionEvent e) { 
JRadioButton rBscelto = (JRadioButton) e.getSource(); 
for (int n = 0; n < 3; n++) 
if (rBscelto == rBot[n]) { 
lab.setText("Scelta " + n); 
cp.validate();return; 





Applet started. 


Figura 10.6 Esempio di JRadioButton. 
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3.2.6 Class JMenu, JMenuBar e JMenuItem 


La classe JMenu rappresenta un menù provvisto di una serie di voci (item) 
costituite da oggetti della classe gJMenuItem e disposto su una barra dei menù 
definita come istanza della classe JMenu. 


La gerarchia delle suddette tre classi è la seguente: 


java.lang.Object 
|_ java.awt.Component 
|. java.awt.Container 
|_ java.swing.JComponent 
|_| java.swing.JMenuBar 
|_ java.swing.AbstractButton 


|_ java.swing.JMenuItem 


|_ java.swing.JMenu 


Un esempio di applicazione di queste tre classi è fatto del programma seguente: 





// J06menu.java () Esempio di JMenu con JMenuBar e JMenuItem 





import javax.swing.*; 
import javax.swing.border.*; 
import java.awt.*; 

import java.awt.event.*; 















public class JO06menu extends JApplet { 






JMenuItem itemBianco, itemNero, itemRosso, itemVerde, itemQuadrato, 
itemCerchio, itemPenta, itemEsa, itemDodeca; 






Label lab; 










public void init({) { 
Container container = this.getContentPane({); 









container. setLayout (new BorderLayout ()); 
lab = new Label ("****ee") 5 
lab.setFont (new Font("", Font.BOLD, 16)); 
container.add{"South", lab); 

JMenuBar menuBar = new JMenuBar(); 

menuBar.setBorder (new BevelBorder (BevelBorder. RAISED) ); 
menubar .setBorderPainted (true); 
container.add(menuBar, BorderLayout .NORTH) ; 











JMenu menuColore = new JMenu("Colore", true) ; 
menuBar.add(menuColore) ; 

menuColore.add(itemBianco = new JMenultem({"Bianco")); 
menuColore.add(itemNero = new JMenuItem("Nero")}; 
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menuColore.addSeparator(); 
menuColore.add(itemRosso = new JMenuItem("Rosso")}; 
menuColore.add(itemVerde = new JMenuItem("Verde")); 


JMenu menuForma = new JMenu("Forma") ; 
menuBar.add(menuForma) ; 

JMenu menuPoli = new JMenu("Poligono"); 
menuForma.add(menuPoli) ; 

menuForma,.addSeparator(); 

menuForma.add(itemQuadrato = new JMenuItem("Quadrato")); 
menuForma.add(itemCerchio = new JMenultem("Cerchio")); 


a a i n 


menuPoli.add(itemPenta = new JMenultem("Pentagono") ); 
menuPoli.add(itemEsa = new JMenuItem("Esagono") ); 
menuPoli.add{itemDodeca = new JMenuItem("Dodecagono"}); 


AAT IA I 


ascoltaMenu am = new ascoltaMenu(); 


itemBianco.addActionListener (am); 
itemNero.addActionListener (am); 
itemRosso.addActionListener (am) ; 
itemVerde.addActionListener (am) ; 
itemQuadrato.addActionListener (am); 
itemCerchio.addActionListener (am); 
itemPenta.addActionListener (am) ; 
itemEsa.addActionListener (am); 
itemDodeca.addActionListener (am); 

} 


class ascoltaMenu implements ActionListener { 
public void actionPerformed(ActionEvent ae) { 

JMenuItem menuItem = (JMenuItem) ae.getSource({); 
if (menuItem == itemBianco) lab. setText ("bianco"); 
if {menuItem == itemNero) lab. setText ("Nero"); 
if (menuitem itemRosso) lab. setText ("Rosso"); 
if (menuItem itemverde) lab.setText ("Verde"); 
if (menulItem itemQuadrato) lab. setText ("Quadrato"); 
if (menuItem itemCerchio) lab.setText("Cerchio"); 
if (menuItem itemPenta) lab. setText ("Pentagono"); 
if (menuItem itemEsa) lab. setText ("Esagono"); 
if (menultem itemDodeca) lab. setText ("Dodecagono") ; 





La figura 10.7 mostra l‘applet con la barra dei menù e un menù aperto con il 
suo sottomenù anch'esso aperto. 
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Esagono | 0 
Applet started. 





Figura 10.7 Esempio di un’applet con barra dei menu. 


3.2.7 Classe JTabbedPane 


La classe JTabbedPane rappresenta 


Un esempio di un JTabbedPane è quello del programma seguente: 


// 307tabbed.,java (F.Spagna) Esempio di JTabbedPane 


import javax.swing.*; 
import javax.swing.event.*; 
import java.awt.*; 


public class J07tabbed extends JApplet { 
String[] tips = { "prima scelta", "seconda scelta", "terza scelta" }; 
public void init() { 
JTabbedPane TP = new «TabbedPane(JTabbedPane.BOTTOM); 
TP. addchangeListener (new ascoltatore({)); 
for (int n = 0; n < 3; n++) { 


JLabel lab = new JLabel("QUESTO E' IL PANE N." + n, JLabel.CENTER); 
TP.addTab("selez." + n, null, lab, tips[n]); 


} 
getContentPane().add(TP); 


} 
class ascoltatore implements ChangeListener { 


int scelta = -1; // valore iniziale 


public void stateChanged(ChangeEvent ce) { 
JTabbedPane tp = ({JTabbedPane) ce.getSource(); 


// disabilita il tab selezionato e riabilita l'ex 
if (scelta == -1 || scelta != tp.getSelectedIndex()) { // se la volta 


tp.setEnabledAt (tp.getSelectedIndex(), false); 


if (scelta l= -1) // sea non prima volta 


tp.setEnabledAt (scelta, true); 
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} 
scelta = tp.getSelectedIndex(); // conserva la nuova selezione 


La figura 10.8 mostra l'aspetto dell'applet dell'esempio. 


(ES Applet Viewer: tabbed.class 





Applet started. 


Figura 10.8 Esempio di un JTabbedPane. 


3.2.8 Classe JTable 


La classe JTable rappresenta 


Un esempio della massima semplicità per la creazione di una tabella tipo 
JTable é il seguente: 


// TOBjtable.java (F.Spagna) Il piu' semplice esempio di JTable 
import javax.swing.*; 
public class JO08jtable extends JApplet { 


public void init() { 


JTable tabella = new JTable(6, // 6 righe a 5 colonne 
getContentPane(}).add(tabella); 
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L'esempio è assolutamente inutile, ma è stato fatto solo per mostrare la semplicità della 
creazione di una griglia di tipo JTable. In figura 10.9 è riportata la tabella come si 
presenta con l’appletviewer. 





‘Applet started 


Figura 10.9 Semplice esempio di Jtable. 


Un esempio invece con celle riempite di dati è fatto di seguito: 


// 3J09jtable2.java (F.Spagna) Il piu' semplice esempio di JTable 


import javax.swing.*; 
import java.awt.*; 
import java.util.*; 


public class J09jtable2 extends JApplet { 
> 
String[}] titoli = {"italiano", "francese", "valore", "si/no"}; 
Object[][] celle = { 
{ "uno", "un", new Integer(1}, new Boolean(false) ), 
{ "due", "deux", new Integer(i), new Boolean(true} ©), 
{ "tre", "trois", new Float(3.3), new Boolean(true) }, 
{ "quattro", "quatre", new Float(4.4), new Boolean(false) } }; 


public void init() { 


JTable tabella = new JTable(celle, titoli}; 
getContentPane().add(tabella.getTableHeader(), BorderLayout .NORTH) ; 
getContentPane().add(tabella); 


In figura 10.10 si vede la griglia con le celle contenenti i dati. 
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Applet started. 





Figura 10.10 Una JTable con celle riempite di valori. 


3.2.9 Classi di testo con stile 


Le classi JTextField €e JTextArea presentano tutto il loro testo 
(rispettivamente a singola riga o a multi-righe) in uno stile unico: una volta definiti 
in esse un font, un colore di testo ed un colore di fondo (caratteristiche dello 
“ stile”) questi restano costanti per tutto il componente. Se si vuole invece poter 
assegnare uno stile diverso a diverse porzioni del testo si possono usare le due 
classi di componenti Swing con testo “styled ” (o “formattea”), che sono la 
JTextPane ela JEditorPane. Facendo un confronto tra queste due classi si noti 
che, mentre JEditorPane è adatto per presentare una pagina formattata fissa, 
è invece carente di funzionalità per quanto riguarda l'inserimento di testo 
(editing), cosa per la quale JTextPane è molto piu flessibile (anche se il suo uso 
non è molto semplice). 


JEditorPane is used to render data content such as HTML, RTF, etc. JEditorPane is 
designed around the concept of a page, or a single source of data. It works very 
well to display fixed amounts of styled text (a Web page, for instance), but tends 
to lack functionality for inserting and appending text to its document once set. 


JTextPane is much more malleable than JEditorPane in terms of the insertion 
and appending of text, but it is not quite as easy to use. In order to use a 
JTextPane, vou need to associate an attribute set with each of the pieces of text 
that you insert. We'll discuss attribute sets shortly. 
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3.2.10 Classe TEditorPane 


La classe JEditorPane permette di presentare una pagina con contenuto 
formattato (styled), per esempio in formato HTML o altro formato predefinito. 


In un oggetto di TEditorPane ci sono due modi alternativi per mostrare una pagina: 
o stabilire la pagina da visibilizzare (con il metodo setPage (URL url), che visualizza 
una pagina Web) affidandosi ad essa stessa per averne definito il tipo di contenuto, oppure 
stabilire esplicitamente a priori il tipo di contenuto (content type) per il JEditorPane 
con il metodo setContentType(String type) (per una pagina Web l’argomento 
sarebbe "text /html")e poi aggiungere il testo contenuto al componente con il metodo 
setPage (URL url),oppure il setText (String text): se il testo ha già un 
formato HTML il JEditorPane si incaricherà di interpretarlo. I tag HTML riconosciuti 
sono quelli aderenti alla specifica HTML 3.2 (è quindi compreso anche il <table>). 


Una cosa importante da notare è che quando sono visualizzati i file HTML, sulla pagina 
compaiono dei widget grafici in corrispondenza dei tag <head> e <title> del 
documento, a meno che si invochi il metodo setEditable(false) del 
JEditorPane che ha l’effetto di nasconderli. 


I tag HTML riconosciuti sono quelli aderenti alla specifica HTML 3.2 (è quindi 
compreso anche il <table>). 


Ecco qui presentato un esempio sull’uso di tale classe: 







// Jl0editpane.java (F.Spagna) Esempio di JEditorPane 











import java.awt.event.*; 
import java.awt.*; 
import javax,swing.*; 
import javax.swing.text.*; 
import java.util.*; 












public class Jl0editpane extends JFrame{ 






public editpane() { 
super("Esempio di JEditorPane"); 

} 

public static void main(String[] args) { 








editpane fram = new editpane(); 
JEGitorPane editor = new JEditorPane(); 

editor.setContentType ("text/html"); 

editor.setEditable({false); 

String editorText = "<html><head><title>Titolo documento</title></head>" 
+ " <body bgcolor=\"white\">" 

+ "<font face=\"arial, helvetica\"><div align=\"center\">" 

+ "Testo centrato</div>" 

+ “<table border=1 cellpadding=0 cellspacing=10><tr><td>" 
+ "Cella 0,0</td><td>Cell 1,0</td>" 
+ 
+ 
+ 








"<td>Cella 2,0</td></tr><tr><td>Cella 0,1</td>" 
"<tA>Cella 1,1</td><td>Cella 2,1</td></tr></table>" 
"<h2>Questo è un titolo di livello 2</h2>" 
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+ "</font></body></html>"; 
editor.setText(editorText); 


JPanel pan = new UPanel{(}; 
pan. setLayout (new BorderLayout()); 
pan. set PreferredSize (new Dimension(320, 240)); 
pan. add (new JScrollPane(editor) ); 
fram.setContentPane(pan) ; 
fram. addWindowListener (new WindowAdapter() { 
public void windowC losing (WindowEvent e) { 
System.exit(0); 
} 
)3 
fram. show(); 
fram.pack(); 





Figura 10.11 Esempio diun JEditorPane. 


Un altro interessante esempio dell'utilizzazione di un JEditorPane per creare 
un browser Internet della massima semplicità è il seguente: 


// Jlinavigatore. java (F.Spagna) Esempio di JEditorPane funzionante da browser 
// tratto da un esempio di "Pure JFC Swing" [8.1] 


import javax.swing.*; 
import javax.swing.event.*; 
import java.awt.*; 

import java.awt.event.*; 
import java.net.*; 


public class Jllnavigatore extends JFrame { 
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JTextField tf; 
JEditorPane ep; 


public navigatore() { 
super ("navigatore"); // titolo del frame 
Container cp = this.getContentPane(); ff content pane del frame 
JPanel pan = new JPanel(new GridLayout (2, 1}); // crea panel 
pan.add(new JLabel("URL richiesto: ")); // con un label messo su 
tf = new JTextField("http://"); // crea un text field 
tf.setFont(new Font ("", Font.BOLD, 14)); 
tf.addActionListener(new TextFieldListener()); // con suo listener 
pan.add(t£); // e lo mette quindi sul panel 
cp.add(pan, BorderLayout.NORTH); // panel sul content pane 
ep = new JEditorPane(); // crea un editor pane 
ep.setEditable(false); // per non mostrare i widget 
JScrollPane sp = new JScrollPane(ep); // messo in scrollpane 
cp.add(sp); // e anche scroll pane sul content pane 
addWindowListener{new WindowEventHandler()); // listener chiusura frame 
setDefaultClose0peration(WindowConstants.DISPOSE_ON_ CLOSE); 
setSize(450, 340); // caratteristiche del frame 
setBackground(Color.lightGray) ; 
setForeground (Color.black); 
show (); // mostra il 
tf£.requestFocus(); // richiede il focus al text 

} 

public static void main(String[] args) { 
new navigatore(); 

} 

// classe interna listener del text 
class TextFieldListener implements ActionListener { 


public void actionPerformed(ActionEvent ae) { 

URL pageURL = null; 
try { 

pageURL = new URL(tf.getText()); // crea URL richiesto in 
} catch (MalformedURLException me) { 

System.out.println("MalformedURL"); } 

try { 

ep.setPage(pageURL) ; // pagina mostrata in editor pane 
} catch (java.io.IOException ioe) { 

System.out.println("IOException while loading page"); } 


// classe interna listener per la chiusura del frame 
class WindowEventHandler extends WindowAdapter { 


public void windowClosing(WindowEvent evt) { 
System.exit(0); 





Quando nel campo di input viene immessa la stringa di un'URL la pagina Web è 
visualizzata (con funzionalità ovviamente molto limitate). La figura 10.12 seguente 
fa vedere un esempio reale: 
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Figura 10,12 Esempio di un JEditorPane utilizzato come navigatore Web. 


3.2.11 Classe JText Pane 


Eccone un esempio: 





‘f/f Ji2textpane. java (F. spagna) Esempio di JTextPane 







import java.awt.event.*; 
import java.awt.*; 

import javax.swing.*; 
import javax.swing.text.*; 
import java.util.*; 














public class Ji2textpane extends JFrame { 






public textpane() { 
super ("Esempio di JTextPane"); 






public static void main(String[] args) { 
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textpane fram = new textpane(); 
JTextPane textPane = new JTextPane(); 
text Pane.setEditable(false) ; 
SimpleAttributeSet BoItR = new SimpleAttributeSet(}; 
StyleConstants.setForeground(BoItR, Color.red); 
StyleConstants.setBold(BoItR, true); 
StyleConstants.setItalic(BoItR, true); 
SimpleAttributeSet CeB = new SimpleAttributeSet (); 
StyleConstants.setForeground(CeB, Color.black); 
StyleConstants.setAlignment (CeB, StyleConstants.ALIGN CENTER); 
SimpleAttributeSet LarB = new SimpleAttributeSet (); 
StyleConstants.setForeground(LarB, Color.black); 
StyleConstants.setFontSize(LarB, 20); 
try { 
Document doc = textPane.getDocument(); 
doc.insertString(doc.getLength(), "Testo nero centrato\n", CeB); 
textPane.setParagraphAttributes(CeB, true); 
doc. insertString(doc.getLength(), "Testo bold italic rosso\n", BoItR); 
doc.insertString(doc.getLength(), "Testo nero a 20 punti\n", LarB); 
} catch(BadLocationException exp) { exp.printStackTrace(}; } 
JPanel pan = new JPanel({); 
pan.setLayout (new BorderLayout ()); 
pan. setPreferredSize(new Dimension(320, 240)); 
pan.add(new JScrollPane(textPane) ); 
fram.setContentPane (pan); 
fram.addWindowListener (new WindowAdapter() { 
public void windowClosing(WindowEvent e) { 
System.exit (0); 

























} 






3); 
fram.show(); 
fram.pack(); 







La finestra risultante è raffigurata in figura 10.13. 


Esempio di JTextPane 
Testo nero centrato 
Testo bold italic rosso 


iTesto nero a 20 punti 












3.2.12 Classe JSplitPane 


La classe JSplitPane rappresenta 


Un esempio con uno JSplitPane contenente un altro gsplitPane è stato 
fatto con il codice seguente: 








// T13split.java {F.Spagna) Esempio di JSplitPane 






import javax.swing.*; 
import java.awt.*; 









public class Ji3split extends JApplet { // split pane 2 






| eae 
boolean continuousLayout = true; //# |N | | tre 
Icon iconl = new ImageIcon("anjv.gif"); /1 |----- | E | scroll 
Icon icon2 = new Imagercon("banni.gif”); 11 | sw | | pane 
Icon icon3 = new ImageIcon("bann2.gif"); et =------------- 






public void init() { 









JLabel labell 
JLabel label2 
JLabel label3 


new JLabel (icon1); ff 3 label con icona 
new JLabel (icon2); 
new JLabel (icon3); 






feo on 











JScrollPane NW = new JScrollPane(label1); // su 3 scrollpane 
JScrollPane SW = new JScrollPane(label2); 
JScrollPane ES = new JScrollPane(label3); 








JSplitPane splitPanel = new JSplitPane(JSplitPane. VERTICAL SPLIT, 









continuousLayout, NW, SW); // 2 scrollpane su splitpane 
splitPanel.setOneTouchExpandable (true); // collapse/expand widget 
splitPanel.setDividerSize(2); // dimensione divisore 





splitPanel.setDividerLocation(0.5); // posizione iniziale del divisore 






JSplitPane splitPane2 = new TSplitPane(JSplitPane.HORIZONTAL_ SPLIT, 
splitPanel, ES); // splitpanei e terzo scrollpane su split esterno 
splitPane2.setOneTouchExpandable (true); // collapse/expand widget 
splitPane2.setDividersize(2); // dimensione divisore 
splitPane2.setDividerLocation(0.4); // posizione iniziale del divisore 









getContentPane().add(splitPane2); // split pane esterno su content pane 
} // dell'applet 






L'applet risultante è riprodotta in figura 10.14 dopo l'intervento dell'utente. 
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TSINTIENZIEE split.class 


Applet started. 





Figura 10.14 Composizione di diversi TSplitPane. 


3.2.13 Classe JSlider 


La classe JSlider rappresenta 


Un esempio dell'uso diuno JSlider è presentato qui di seguito: 


// TJl4slider, java (F.Spagna) Esempio di JSlider 


import javax.swing.*; 
import javax.swing.event.*; 
import java.awt.*; 

import java.awt.event.*; 


public class Jldslider extends JApplet { 


JLabel lab; 

JSlider slider; 

public void init() { 
Container cp = this.getContentPane(); 
cp.setBackground (Color.lightGray) ; 
cp.setLayout (new GridLayout(4, 1)); 
lab = new JLabel("Valore dello slider: 50", JLabel.CENTER); 
lab. setFont (new Font ("Helvetica", Font.BOLD, 14)}; 
cp.add(lab); 
int min = 0, max = 100, iniz = 50; 
slider = new JSlider(JSlider.HORIZONTAL, min, max, iniz); 
slider.addChangeListener(new ascoltatore()); 
slider.setPaintTicks(true); 
slider.setMajorTickSpacing(10); 
slider.setMinorTickSpacing (5); 
cp.add(slider); 
slider.setLabelTable(slider.createStandardLabels(10)); 
slider.setPaintLabels(true); 
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class ascoltatore implements ChangeListener { 
public void stateChanged(ChangeEvent chngEvt) { 

JSlider sliderTemp = (JSlider) chngEvt.getSource(); 

if (sliderTemp == slider) 
lab.setText ("Valore dello slider: " + slider.getValue()); 










‘Applet started. 





Figura 10.15 Esempio di JSlider. 


3.2.14 Classe Timer 


La classe Timer fornisce un mezzo per scandire dei tempi con una 
successione di eventi periodici. 


3.2.15 Classe TProgressBar 


La classe JProgressBar rappresenta 


Ecco un esempio chge fa vedere come si può usare di JProgressBar: 


// J1l5progress.java (F.Spagna) Esempio di Timer e JProgressBar 
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import javax.swing.*; 

import javax.swing.border.*; 
import java.awt.*; 

import java.awt.event.*; 


public class J15progress extends JApplet { 


Container cp; 

JButton bot, bstop; 
JTextField tf1, tf2; 
JLabel iabel3; 
JProgressBar pBar; 
Timer timer; 

static int counter = 0; 


public void init() { 


} 


cp = this.getContentPane(); 
Cp.setLayout (new GridLayout(6, 1)); 


JLabel labell = new JLabel(" conta fino a: ", JLabel.LEFT); 
labell.setFont (new Font ("Dialog", Font.BOLD, 18)); 
cp.add(labell); 

cp.add(tf1 = new JTextField{"60", 4)); 


JLabel label2 = new JLabel{(" intervallo: ", JLabel.LEFT); 
label2.setFont (new Font ("Dialog", Font.BOLD, 18)); 
cp.add(label2); 

cp.add(tf2 = new JTextField("1000", 4)); 

bot = new JButton("Conta"); 

bot .addActionListener (new ascoltBot()); 
cp.add(bot); 

bstop = new JButton("Stop"); 
bstop.addActionListener (new ascoltBot()); 
cp.add(bstop); 

label3 = new JLabel(" contati: 0", JLabel.CENTER) ; 
label3.setFont (new Font ("Dialog", Font.BOLD, 18)); 
cp.add(label3); 

pBar = new JProgressBar(); 
pBar.setStringPainted(true); 
pBar.setBorder(BorderFactory.createLineBorder(Color.blue, 2)}3 
pBar.setBackground(Color.white); 
pBar.setForeground(Color.red); 

pBar.setMinimum({ 0); 
pBar.setMaximum(Integer.parseInt(tfl.getText())); 
cp.add(pBar); 

timer = new Timer(0, new ascoltTimer()); 


class ascoltTimer implements ActionListener { 


} 


public void actionPerformed (ActionEvent e) { 
counter++; 
pBar.setValue (counter); 
label3.setText(" contati: " + counter); 
if (counter >= Integer.parseint (tf1.get Text ())) 
timer.stop(); 


class ascoltBot implements ActionListener { 


public void actionPerformed (ActionEvent e} { 
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JButton button = {JButton)}) e.getSource(); 
if (button.getText() == "Conta") { 
timer.setDelay (Integer.parseInt (tf2.getText())); 
label3.setText(" contati: 0"); 
pBar. setMaximum(Integer.parseInt(tfl.getText())); 
counter = 0; 
timer.start(); 












{button.getText{} == "Stop") { 
counter = 0; 
timer.stop(); 






Applet started. 





Figura 10.16 Esempio di JProgressBar edi Timer. 


3.2.16 Classe JFileChooser 


La classe JFileChooser permette la creazione di 


Ecco un esempio di come si usa JFileChooser qui di seguito: 


// J16chooser.java (F.Spagna) Esempio di JFileChooser 





import javax.swing.*; 
import javax.swing.border,*; 
import java.awt.*; 
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import java.awt.event.*; 
import java.io.*; 


public class J16chooser extends JFrame { 


JMenuItem openMI, saveMI, saveAsMI, exitMI; 
JFileChooser fc; 

Container cp; 

JLabel lab; 

File file, fileScelto; 


public chooser() { 


} 


this.addWindowListener(new FrameClosing()); 

cp = this.getContentPane(); 

lab = new JLabel(); // per messaggi vari sul fondo 
lab.setFont (new Font ("", Font.BOLD, 20)); 
cp.add(lab); 

JMenuBar menuBar = new JMenuBar(); 
menuBar.setBorder(BorderFactory.createEtchedBorder(}}); 
cp.add(menuBar, BorderLayout.NORTH); 

JMenu menuFile = new JMenu("File"); 
menuBar.add(menuFile) ; 

JMenuItem newMI = new JMenultem( "Nuovo" ); 
newMI.setEnabled (false); 

menuFile.add(newMTI) ; 

openMI = new JMenuitem("Apri"); 
openMI.addActionListener(new MIActionListener()); 
menuFile.add{openMI}; 

menuFile.addSeparator(); 

saveMI = new JMenuItem("Salva"); 
saveMI.setEnabled(false); 

menuFile.adA(saveMI); 

saveAsMI = new JMenultem("Salva con nome"); 
saveAsMI.addActionListener (new MIActionListener()); 
menuFile.add({saveAsMI) ; 

menuFile,addSeparator(); 

menuFile.addSeparator(); 

exitMI = new JMenultem("Esci"); 
exitMr.addActionListener(new MIActionListener()}}; 
menuFile.,add(exitMI); 

JMenu editMenu = new JMenu ("Modifica"); 
menuBar.add(editMenu); 


class MIActionListener implements ActionListener { 


public void actionPerformed(ActionEvent ae) { 
JMenuItem menuItem = (JMenuItem) ae.getSource(); 
if {menuItem == openMI) { 
if (file == null) 
fc = new JFileChooser(); // punta sulla home directory 
else 
fc = new JFileChooser(file); // punta su file path specificato 
int selected = fc.showOpenDialog(cp); 
if (selected == JFileChooser.APPROVE_OPTION) { // bottone Open 
file = fc.getSelectedFile(); 
lab.setText ("File selezionato da aprire: "+ file.getName(}}); 
lab. setHorizontalAlignment (JLabel .CENTER) ; 
return; 
} 
else if (selected == fc.CANCEL OPTION) { 
lab.setText ("Non selezionato file da aprire"); 
lab. setHorizontalAlignment (JLabel .CENTER) ; 
return; 


} 


} 
else if (menuItem == saveAsMI) { 
// inserire qui il codice per salvare il file... 
fc = new JFileChooser(); 
int selected = fc.showSaveDialog(cp); 
fileScelto = new File("UNTITLED"); 
fc.setSelectedFile(fileScelto); 
if (selected == JFileChooser.APPROVE_OPTION) { 
fileScelto = fc.getSelectedFile(); 
lab.setText ("File selezionato da salvare: "+ file.getName()); 
lab.setHorizontalAlignment(JLabel.CENTER): 
return; 
} 
else if (selected == fc.CANCEL OPTION) { 
lab.setText ("Non selezionato file da salvare"); 
lab. setHorizontalAlignment (JLabel.CENTER) ; 
return; 
> 
} 
else if (menulItem == exitMI) 
System.exit (0); 
} 
} 
class FrameClosing extends WindowAdapter { 
public void windowClosing (WindowEvent e) { 
System.exit(0); 
} 
} 
public static void main(String[] args) { 
chooser frame = new chooser(); 
frame.setTitle("Esempio di JFileChooser"); 
frame.setSize(450, 300); 
frame.setVisible(true); 





Le figure 10.17, 10.18 e 10.19 mostrano l'applicazione rispettivamente nello 
stato iniziale e all'apertura delle finestre di apertura file e salvataggio file. 
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Figura 10.17 Applicazione con un JFileChooser allo stato iniziale. 
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Figura 10.19 Finestra di salvataggio file in un'applicazione con un 
JFileChooser, 
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3.2.17 Classe TPopupMenu 


La classe JPopupMenu permette il richiamo di un menù tipo popup al clic del 
bottone destro del mouse su un componente. 


Presentiamo un esempio di JPopupMenu: 





// Jl7popup.java (F.Spagna) Esempio di JPopupMenu 






import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 








public class J17popup extends JFrame { 






JPopupMenu popupMenu; 
JMenuItem item[] = new JMenulItem[5]}; 

String nome[] = { "uno", "due", "tre", "quattro", "cinque" }; 
Container container; 











public popup() { 

this .addWindowListener (new FrameClosing()}); 
container = this .getContentPane(); 
JLabel lab = new JLabel("Fare click con bottone destro del mouse"); 
lab.setFont (new Pont ("*, Font .BOLD, 16)); 
container.add(lab); 
popupMenu = new JPopupMenu({ "Test Popup Menu") ; 
for (int n= 0; n< 5; n++) { 

item[n] = new JMenuItem(nome[n]}); 

popupMenu.add(item[n]); 

if (n==0 || n==3) 

popupMenu.addSeparator(); 














} 
PopupMenuListener pml = new PopupMenuListener () ; 
container.addMouseListener (pml); 







} 
class PopupMenuListener extends MouseAdapter { 
public void mousePressed(MouseEvent me) { 
showPopup (me); 







} 
public void mouseReleased(MouseEvent me) { 
showPopup (me); 






} 
private void showPopup{MouseEvent me) { 
if (me.isPopupTrigger()) { 
popupMenu.show(me.getComponent (), me.getX(), me.gety()); 







} 






H 






} 
class FrameClosing extends WindowAdapter { 
public void windowClosing (WindowEvent e) { 
System.exit(0); 







} 






} 
public static void main(String[] args) { 
popup frame = new popup(); 
frame.setTitle("JPopupMenu"); 
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frame.setSize(350, 150); 
frame. setVisible (true); 





} 


La figura 10.20 
destro del mouse i 


mostra l'applicazione con 


il menù attivato con un clic del tasto 
nun punto in alto a destra 


del contenitore. 





Figura 10.20 Esempio di JPopupMenu. 
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